Create transaction

Creates an onramp transaction

This endpoint will create an onramp transaction.

Note:

• Supported Currencies: To view the list of all the fiat currencies supported by CoinMena, click here.

• Supported paymentMethodType values:

• For AED -> AED-BANK-TRANFER

Create an Onramp transaction.

POST https://integration.coinmena.com/onramp/api/v2/whiteLabel/onramp/createTransaction

Request Body

Name	Type	Description
fromCurrency*	String	Base currency of the trading pair E.g. of fromCurrency: AED
toCurrency*	String	Quote currency of the trading pair E.g. of toCurrency: usdc | usdt | eth
chain*	String	supported networks by CoinMena for onchain transactions E.g. of supported networks: usdt - bep20 | matic20 | erc20 | trc20 usdc - bep20 | matic20 busd - bep20 eth - erc20 | matic20
paymentMethodType*	String	payment Method Type for CoinMena Transaction. E.g. of payment method Type: For AED -> AED-BANK-TRANSFER
depositAddress*	String	On chain destination for coin transfer
customerId*	String	Unique id received from /kyc/url
fromAmount*	String	Amount of fiat that the user would deposit.
toAmount*	String	An estimate of crypto quantity user will receive
rate*	String	Expected price estimate from quote endpoint

200: OK Success

{
    "status": 1,
    "code": 200,
    "data": {
        "transactionId": "880663",
        "createdAt": "2024-05-08 12:38:11",
        "fiatAmount": "1000",
        "fiatPaymentInstructions": {
            "bank": {
                "iban": "AE6609600002090XXXXXXX4",
                "name": "COINMENA FZE",
                "bank": "ZAND",
                "type": "CORPORATE CURRENT ACCOUNT AED",
                "address": "The property of Sheikh Suhail bin Maktoum bin Juma Al Maktoum - Deira - Port - 0109-M01, Office No - 0109-M01. Dubai",
                "email": "[e-mail]",
                "phoneNumber": "9XX505XXXX",
                "transferCode": "Purchase of goods and services",
                "p.o. box": "74XX7"
            },
            "bankNotes": [
                {
                    "type": 1,
                    "msg": "Your trade will be executed at the price when your funds are received"
                },
                {
                    "type": 1,
                    "msg": "You can only send AED from an individual bank account registered in your name."
                }
            ],
            "otp": "5242",
            "type": "AED-BANK-TRANSFER"
        }
    }
}

400: Bad Request Missing required parameter(s)

{
    "status": 0,
    "code": 400,
    "error": "Missing Required parameters -> fromCurrency, toCurrency, fromAmount, toAmount, rate, chain, paymentMethodType, depositAddress."
}

500: Internal Server Error Internal Server Error

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

Response(AED)

{
    "status": 1,
    "code": 200,
    "data": {
        "transactionId": "880663",
        "createdAt": "2024-05-08 12:38:11",
        "fiatAmount": "1000",
        "fiatPaymentInstructions": {
            "bank": {
                "iban": "AE6609600002090XXXXXXX4",
                "name": "COINMENA FZE",
                "bank": "ZAND",
                "type": "CORPORATE CURRENT ACCOUNT AED",
                "address": "The property of Sheikh Suhail bin Maktoum bin Juma Al Maktoum - Deira - Port - 0109-M01, Office No - 0109-M01. Dubai",
                "email": "[e-mail]",
                "phoneNumber": "9XX505XXXX",
                "transferCode": "Purchase of goods and services",
                "p.o. box": "74XX7"
            },
            "bankNotes": [
                {
                    "type": 1,
                    "msg": "Your trade will be executed at the price when your funds are received"
                },
                {
                    "type": 1,
                    "msg": "You can only send AED from an individual bank account registered in your name."
                }
            ],
            "otp": "5242",
            "type": "AED-BANK-TRANSFER"
        }
    }
}

Explanation

• status: An integer representing the status of the API response. 1 typically indicates success.

• code: An integer representing the HTTP status code. 200 indicates a successful request.

• transactionId: A string representing the unique identifier for the transaction.

• createdAt: A string representing the timestamp when the transaction was created in the format YYYY-MM-DD HH:MM:SS.

• fiatAmount: A string representing the amount of fiat currency involved in the transaction.

• bank: An object containing bank details required for the fiat payment.

  • iban: A string representing the International Bank Account Number.

  • name: A string representing the name of the account holder or company.

  • bank: A string representing the name of the bank.

  • type: A string describing the type of bank account.

  • address: A string representing the address of the bank.

  • email: A string representing the support email address.

  • phoneNumber: A string representing the support phone number.

  • transferCode: A string representing the purpose or description of the bank transfer.

  • p.o. box: A string representing the post office box number.

• bankNotes: An array of objects containing additional notes regarding the bank payment.

  • type: An integer representing the type of note.

  • msg: A string containing the message of the note.

• otp: A string representing the One-Time Password for verification.

• type: A string representing the type of payment method, in this case, "AED-BANK-TRANSFER".