Get Payment

The Get Payment Details endpoint allows merchants to request and review comprehensive information about a specific payment.

This endpoint returns the current status, transaction history, and key details associated with the payment, enabling merchants to track and verify payment progression accurately. Use this endpoint to monitor the state of each transaction, confirm payment amounts, and access metadata for customer support or reconciliation purposes. This ensures you stay updated on payment statuses without relying on notifications or redirects alone.

POSTpayment/detail

Request Body

Name	Type	Description
reference*	String	Your payment reference
payment_code*	String	Payment code supplied
key*	String	Merchant's API Key
hash*	String	MD5 Hash key+reference+api_secret or key+payment_code+api_secret

200: OK Get Payment Failed

{
  "status": "nok",
  "message": "Get Payment Detail Failed!",
  "error": "Payment Reference or Payment Code is required",
  "validated": false
}

200: OK Get Payment Success

{
    "status": "ok",
    "payment": {
        "merchant_id": "66ce8d3588300aa3b53a59e5",
        "payment_code": "qBBiRwD4G9",
        "address": "0x62ba1ef84aac42c6b34d8c03b83f5951ccce29b9",
        "amount": "523.62",
        "original_amount": "1000",
        "precision": 0,
        "display_digits": 2,
        "txid": "0x19b4db0adf1969a76c637e7d1d004ad0f045fb4e777e39dc5a4d953001359600na11000002",
        "all_txids": "0x19b4db0adf1969a76c637e7d1d004ad0f045fb4e777e39dc5a4d953001359600na11000002,0x19b4db0adf1969a76c637e7d1d004ad0f045fb4e777e39dc5a4d953001359600na11000001",
        "asset_id": "5e2523c4ce4e2f0684847c14",
        "asset_symbol": "USD",
        "from_address": "0xF859E041997b1eF5Faf1Ae6ab95205c0b4a50028",
        "language": "en",
        "payment_status": "3",
        "status": "completed",
        "description": "dd",
        "payment_reference": "dd",
        "terminal_id": "66ce906e88300aa3b53a61be",
        "paid_amount": "1049590000",
        "paid_amount_precision": 6,
        "requested_amount": "1049590000",
        "requested_amount_precision": 6,
        "transactions": [
            {
                "asset_symbol": "USDT",
                "status": "underpaid",
                "quantity": "500000000",
                "executable_quantity": "500000000",
                "tx_id": "0x19b4db0adf1969a76c637e7d1d004ad0f045fb4e777e39dc5a4d953001359600na11000001",
                "tx_time": 1740621599,
                "exchange_rate": 0.95,
                "settlement_amount": "500000000",
                "settlement_amount_precision": 6,
                "settlement_asset": "USDT"
            },
            {
                "asset_symbol": "USDT",
                "status": "paid",
                "quantity": "549590000",
                "executable_quantity": "549590000",
                "tx_id": "0x19b4db0adf1969a76c637e7d1d004ad0f045fb4e777e39dc5a4d953001359600na11000002",
                "tx_time": 1740628652,
                "exchange_rate": 0.95,
                "settlement_amount": "549590000",
                "settlement_amount_precision": 6,
                "settlement_asset": "USDT"
            }
        ],
        "paid_asset": {
            "blockexplorer_url": "",
            "chain_type": null,
            "contract_address": null,
            "_id": "5d7ef24513aa25457e4a5e92",
            "logo": "https://txmasset.com/txmarket.assets/c/usdt.png",
            "tracking_url": "https://sepolia.etherscan.io/tx/",
            "display_digits": 2,
            "precision": 6,
            "symbol": "USDT",
            "name": "USDT",
            "is_active": true,
            "processor": "bitgo",
            "last_checked_block": 0,
            "block_confirmations": 1,
            "type": "erc20",
            "__v": 0,
            "deposit_info_code": "101",
            "withdraw_info_code": "102",
            "payment_info_code": "103",
            "asset_type": "tether-usd",
            "networks": [
                {
                    "name": "erc20",
                    "is_active": true,
                    "symbol": "USDT",
                    "tracking_url": "https://sepolia.etherscan.io/tx/"
                },
                {
                    "name": "tron",
                    "is_active": true,
                    "symbol": "USDT-TRC20",
                    "tracking_url": "https://shasta.tronscan.org/#/transaction/"
                }
            ],
            "shortid": "r@w52jmjq2"
        }
    },
    "message": "Get payment detail successfully"
}
```

Please Note: You can only send one of reference or payment_code and your hash must include that value.

For example if you send reference your hash must be key+reference+api_secret. If you send payment_code your hash must be key+payment_code+api_secret