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 Onramp, click here.
Payment methods: To retrieve the payment methods for all supported fiat currencies for Onramp, click here.
Supported paymentMethodType values:
For INR -> UPI, IMPS
For TRY -> TRY_BANK_TRANSFER
For AED -> AED-BANK-TRANFER
For MXN -> SPEI
For EUR -> SEPA_BANK_TRANSFER
For IDR -> IDR_BANK_TRANSFER
For GBP -> FASTER_PAYMENTS
For VND -> VIET-QR
For NGN -> NG-BANK-TRANSFER
For BRL -> PIX
For ZAR -> ZAR-BANK-TRANSFER
For THB -> THAI_QR

AED Onramp Transaction Flow

Add a fiat account using the Add Fiat Account API or through the Bank Widget Url.
Retrieve the fiatAccountId from the List FiatAccounts API and include this ID in the createTransaction request.

Create an Onramp transaction.

POST https://api.onramp.money/onramp/api/v2/whiteLabel/onramp/createTransaction

Request Body

Name

Type

Description

fromCurrency*

String

Base currency of the trading pair E.g. of fromCurrency:

INR | TRY | AED | MXN | IDR | EUR

toCurrency*

String

Quote currency of the trading pair

E.g. of toCurrency: usdc | usdt | eth

chain*

String

supported networks by onramp 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 Onramp Transaction. E.g. of payment method Type:

For INR -> UPI, IMPS

For TRY -> TRY_BANK_TRANSFER

For AED -> AED-BANK-TRANSFER

For MXN -> SPEI

For IDR -> IDR_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

memo

String

Required for processing U.S. transactions on the Stellar blockchain.

fiatAccountId

String

Required only for AED transaction. The user must add a fiat account vi Add Fiat Account or Bank Widget Url and then fetch the fiatAccountId using theList FiatAccounts

{
    "status": 1,
    "code": 200,
    "data": {
        "transactionId": "635",
        "createdAt": "2023-12-08 00:31:44",
        "fiatAmount": "1741",
        "fiatPaymentInstructions": {
            "type": "IMPS",
            "bank": {
                "name": "",
                "accountNumber": "",
                "ifsc": "",
                "type": "",
                "branch": "",
                "bank": ""
            },
            "bankNotes": [
                {
                    "type": -1,
                    "msg": "NEFT not allowed for this account."
                },
                {
                    "type": 1,
                    "msg": "Bank transfers from UPI Apps like gPay, PhonePe, Paytm are working."
                },
                {
                    "type": 1,
                    "msg": "UPI bank transfers, IMPS is allowed for this account."
                }
            ],
            "otp": "3217"
        }
    }
}

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

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

{
    "status": 1,
    "code": 200,
    "data": {
        "transactionId": "635",
        "createdAt": "2023-12-08 00:31:44",
        "fiatAmount": "1741",
        "fiatPaymentInstructions": {
            "type": "IMPS",
            "bank": {
                "name": "",
                "accountNumber": "",
                "ifsc": "",
                "type": "",
                "branch": "",
                "bank": ""
            },
            "bankNotes": [
                {
                    "type": -1,
                    "msg": "NEFT not allowed for this account."
                },
                {
                    "type": 1,
                    "msg": "Bank transfers from UPI Apps like gPay, PhonePe, Paytm are working."
                },
                {
                    "type": 1,
                    "msg": "UPI bank transfers, IMPS is allowed for this account."
                }
            ],
            "otp": "3217"
        }
    }
}

{
    "status": 1,
    "code": 200,
    "data": {
        "transactionId": "15XXX3",
        "createdAt": "2026-02-23 12:50:47",
        "fiatAmount": "1300",
        "fiatPaymentInstructions": {
            "otp": "5XX3",
            "type": "UPI"
        },
        "expiredAt": "2026-02-24 15:50:47"
    }
}

{
    "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": "support@onramp.money",
                "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"
        }
    }
}

{
    "status": 1,
    "code": 200,
    "data": {
        "transactionId": "646",
        "createdAt": "2023-12-10 23:40:29",
        "fiatAmount": "1000",
        "fiatPaymentInstructions": {
            "bank": {
                "clabe": "",
                "name": "",
                "bank": ""
            },
            "bankNotes": [
                {
                    "type": 1,
                    "msg": "Your trade will be executed at the price when your funds are received"
                },
                {
                    "type": 1,
                    "msg": "You can only send MXN from an individual bank account registered in your name."
                }
            ],
            "type": "SPEI"
        }
    }
}

{
    "status": 1,
    "code": 200,
    "data": {
        "transactionId": "638958",
        "createdAt": "2024-02-20 14:26:08",
        "fiatAmount": "20",
        "fiatPaymentInstructions": {
            "bank": {
                "Iban": "",
                "Bic": "",
                "Bank Name": "",
                "Country": ""
            },
            "bankNotes": [
                {
                    "type": 1,
                    "msg": "Your trade will be executed at the price when your funds are received"
                },
                {
                    "type": 1,
                    "msg": "You can only send EUR from an IBAN registered in your name."
                }
            ],
            "type": "SEPA_BANK_TRANSFER"
        }
    }
}

{
    "status": 1,
    "code": 200,
    "data": {
        "transactionId": "880618",
        "createdAt": "2024-05-08 12:24:59",
        "fiatAmount": "1000",
        "fiatPaymentInstructions": {
            "bank": {
                "iban": "TR700005901010130101011089",
                "name": "Bitbns Teknoloji Anonim Şirketi",
                "bank": "Şekerbank"
            },
            "bankNotes": [
                {
                    "type": 1,
                    "msg": "You can only send TRY from an individual bank account registered in your name."
                },
                {
                    "type": 1,
                    "msg": "You can withdraw and send money whenever you want during bank working hours."
                }
            ],
            "otp": "9244",
            "type": "TRY_BANK_TRANSFER"
        }
    }
}

{
    "status": 1,
    "code": 200,
    "data": {
        "transactionId": "647",
        "createdAt": "2023-12-10 23:42:19",
        "fiatAmount": "175889",
        "fiatPaymentInstructions": {
            "bank": {
                "virtualAccount": "",
                "name": "",
                "bank": ""
            },
            "bankNotes": [
                {
                    "type": 1,
                    "msg": "Your trade will be executed at the price when your funds are received"
                },
                {
                    "type": 1,
                    "msg": "You can only send IDR from an individual bank account registered in your name."
                }
            ],
            "type": "IDR_BANK_TRANSFER"
        }
    }
}

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.
fiatAmount -> The amount of fiat that the user would deposit to their bank account.
fiatPaymentInstructions -> This contains the payment instructions.
type -> payment method type
bank -> Bank account details to which the deposit needs to be made.
bankNotes -> additional information regrading bank account and current status.
otp -> reference number

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.
fiatAmount -> The amount of fiat that the user would deposit to their bank account.
fiatPaymentInstructions -> This contains the payment instructions.
type -> payment method type
upi -> UPI details to which the deposit needs to be made.
upiNotes -> additional information regrading bank account and current status.
otp -> reference number (or aka confirmation code)

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.
fiatAmount -> The amount of fiat that the user would deposit to their bank account.
fiatPaymentInstructions -> This contains the payment instructions.
- Iban -> International Bank Account Number
- Bic -> Bank Identifier Code
type -> payment method type
bank -> Bank account details to which the deposit needs to be made.
bankNotes -> additional information regrading bank account and current status.
otp -> reference number (or aka confirmation code)

PreviousQuote

NextGet transaction

Last updated 7 months ago