Get user all transaction

Returns all offramp transaction for a user.

This endpoint will provide all offramp transactions for a user.

Note:

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

Get all offramp transaction for an user

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

Request Body

Name	Type	Description
page*	String	Current page Number Should be greater than 0
customerId*	String	Unique id received from /kyc/url
pageSize*	String	Number of Transactions per page. Should be greater than 0 and less than 500

200: OK Success

{
    "status": 1,
    "code": 200,
    "data": [
        {
            "transactionId": "463",
            "createdAt": "2023-12-07T21:28:41.000Z",
            "updatedAt": "2023-12-08T00:24:03.000Z",
            "fromAmount": "20",
            "toAmount": "8.94",
            "fromCurrency": "USDC",
            "toCurrency": "AED",
            "chain": "matic20",
            "fiatAccountId": "1",
            "status": "2",
            "transactionHash": "0x9819asndan1238haj2h3bdnsmd2j2js"
        },
        {
            "transactionId": "462",
            "createdAt": "2023-12-07T21:26:41.000Z",
            "updatedAt": "2023-12-07T21:26:41.000Z",
            "fromAmount": "20",
            "toAmount": "8.94",
            "fromCurrency": "USDC",
            "toCurrency": "AED",
            "chain": "matic20",
            "fiatAccountId": "1",
            "status": "1",
            "transactionHash": "0x9819asndan1238haj2h3bdnsmd2j2js"
        },
        {
            "transactionId": "461",
            "createdAt": "2023-12-07T21:25:46.000Z",
            "updatedAt": "2023-12-07T21:25:46.000Z",
            "fromAmount": "20",
            "toAmount": "8.94",
            "fromCurrency": "USDC",
            "toCurrency": "AED",
            "chain": "matic20",
            "fiatAccountId": "1",
            "status": "1",
            "transactionHash": "0x9819asndan1238haj2h3bdnsmd2j2js"
        },
        {
            "transactionId": "460",
            "createdAt": "2023-12-07T21:24:42.000Z",
            "updatedAt": "2023-12-07T21:24:42.000Z",
            "fromAmount": "20",
            "toAmount": "8.94",
            "fromCurrency": "USDC",
            "toCurrency": "AED",
            "chain": "matic20",
            "fiatAccountId": "1",
            "status": "1",
            "transactionHash": "0x9819asndan1238haj2h3bdnsmd2j2js"
        },
}

400: Bad Request Missing required parameter

{
    "status": 0,
    "code": 400,
    "error": "Missing parameter -> customerId, page, pageSize."
}

500: Internal Server Error Internal Server Error

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

Response

{
    "status": 1,
    "code": 200,
    "data": [
        {
            "transactionId": "463",
            "createdAt": "2023-12-07T21:28:41.000Z",
            "updatedAt": "2023-12-08T00:24:03.000Z",
            "fromAmount": "20",
            "toAmount": "8.94",
            "fromCurrency": "USDC",
            "toCurrency": "AED",
            "chain": "matic20",
            "fiatAccountId": "1",
            "status": "2",
            "transactionHash": "0x9819asndan1238haj2h3bdnsmd2j2js"
        },
        {
            "transactionId": "462",
            "createdAt": "2023-12-07T21:26:41.000Z",
            "updatedAt": "2023-12-07T21:26:41.000Z",
            "fromAmount": "20",
            "toAmount": "8.94",
            "fromCurrency": "USDC",
            "toCurrency": "AED",
            "chain": "matic20",
            "fiatAccountId": "1",
            "status": "1",
            "transactionHash": "0x9819asndan1238haj2h3bdnsmd2j2js"
        },
        {
            "transactionId": "461",
            "createdAt": "2023-12-07T21:25:46.000Z",
            "updatedAt": "2023-12-07T21:25:46.000Z",
            "fromAmount": "20",
            "toAmount": "8.94",
            "fromCurrency": "USDC",
            "toCurrency": "AED",
            "chain": "matic20",
            "fiatAccountId": "1",
            "status": "1",
            "transactionHash": "0x9819asndan1238haj2h3bdnsmd2j2js"
        },
        {
            "transactionId": "460",
            "createdAt": "2023-12-07T21:24:42.000Z",
            "updatedAt": "2023-12-07T21:24:42.000Z",
            "fromAmount": "20",
            "toAmount": "8.94",
            "fromCurrency": "USDC",
            "toCurrency": "AED",
            "chain": "matic20",
            "fiatAccountId": "1",
            "status": "1",
            "transactionHash": "0x9819asndan1238haj2h3bdnsmd2j2js"
        },
}

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.

• fromAmount -> Quantity of crypto received by the coinmena.

• toAmount -> Actual fiat amount received by user

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

• toCurrency -> fiat used for the transaction.

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

• fiatAccountId -> Unique ID of fiat account to withdraw off-ramped fiat to

• status -> current status of Offramp transaction

  • -4 -> amount mismatch

  • -2 -> transaction abandoned.

  • -1 -> transaction time out.

  • 0 -> order created.

  • 1 -> order confirmed i.e. hash generated.

  • 2 or 10 or 11 -> hash found status.

  • 3 -> over limit (If the user sends a quantity of cryptocurrency that exceeds their KYC limit, their funds will be withheld until reviewed manually).

  • 4 or 12 -> crypto sold.

  • 5 or 13 -> fiat withdrawal initiated to bank

  • 6 or 14 -> fiat withdrawal processed.

  • 7 or 15 -> webhook sent

  • 17 -> provide alternate bank

  • 18 -> processing to alternate bank

  • 19 -> success

• transactionHash -> transaction hash related to this order.