Get transaction

Returns an individual onramp transaction for a user.

This endpoint will retrieve an individual onramp transaction for a user based on a specified transactionId.

Note:

• This endpoint necessitates the inclusion of the customerId parameter, as it is designed to retrieve an user's individual transactions.

• The order status after which SGB can begin fiat-settlement is status: 6.

Get an onramp transaction from transactionId.

POST https://integration.coinmena.com/onramp-bank/api/v1/onramp/transaction

Request Body

Name	Type	Description
transactionId*	String	Onramp transaction orderId
customerId*	String	Unique id received from /kyc/url

200: OK Success

{
    "status": 1,
    "code": 200,
    "data": {
        "transactionId": "550",
        "createdAt": "2023-11-29T01:30:08.000Z",
        "updatedAt": "2023-11-29T01:30:08.000Z",
        "fromAmount": "47",
        "toAmount": "10.1",
        "fromCurrency": "AED",
        "toCurrency": "usdc",
        "paymentMethodType": "",
        "depositAddress": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
        "status": "2",
        "transactionHash": "0x9b34a0e4897cd834847d8bbb8814eba72149f914785c406684d4f887ac"
    }
}

400: Bad Request Missing required parameter

{
    "status": 0,
    "code": 400,
    "error": "Missing parameter -> transactionId."
}

500: Internal Server Error Internal Server Error

{
    "status": 0,
    "code": 500,
    "error": "Unable to fetch Onramp Transaction at the moment. Please try again after some time."
}

Response

{
    "status": 1,
    "code": 200,
    "data": {
        "transactionId": "550",
        "createdAt": "2023-11-29T01:30:08.000Z",
        "updatedAt": "2023-11-29T01:30:08.000Z",
        "fromAmount": "47",
        "toAmount": "10.1",
        "fromCurrency": "AED",
        "toCurrency": "usdc",
        "paymentMethodType": "",
        "depositAddress": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
        "status": "2",
        "transactionHash": "0x9b34a0e4897cd834847d8bbb8814eba72149f914785c406684d4f887ac"
    }
}

Explanation

• status -> 0 is for unsuccessful request, 1 is for a successful one.

• transactionId -> unique identifier of the transaction

• createdAt -> time at which the transaction was created.

• updateAt -> time at which the transaction status is last updated.

• fromAmount -> Amount of fiat received by the coinmena

• toAmount -> actual amount of crypto bought at the time of swap/trade.

• fromCurrency -> fiat used for the transaction.

• toCurrency -> symbol of the coin e.g. USDT).

• chain -> denotes which chain the coin was sent on (e.g. MATIC20) .

• paymentMethodType -> payment method in fiat.

• depositAddress -> Onchain wallet address to which the crypto was withdrawn to.

• status -> current status of CoinMena transaction

  • -4 -> wrong amount sent

  • -3 -> bank and kyc name mismatch

  • -2 -> transaction abandoned

  • -1 -> transaction timed out

  • 0 -> transaction created

  • 1 -> referenceId claimed

  • 2 -> deposit secured

  • 3, 13 -> crypto purchased

  • 4, 15 -> withdrawal complete

  • 5, 16 -> webhook sent

  • 11 -> order placement initiated

  • 12 -> purchasing crypto

  • 14 -> withdrawal initiated

• transactionHash -> transaction hash related to order.