Comment on page
Initiate transaction
Retrieve a bank account for your customers to send fiat to. Once they do, you instantly receive USDT in your wallet.
To do this, Make a POST request to the following endpoint.
https://api.localramp.co/v1/transaction/pay/initiate
The request takes this as the body
{
"reference": "uniqueReference",
"amount": "1000",
"email": "[email protected]",
"currency": "NGN",
"bvn": "123456"
}
With the following header
x-auth-token: <SECRET_KEY>
If the API call is successful, LocalRamp returns the following response:
{
"status": "success",
"data": {
"account_name": "Jaka Technologies",
"account_number": "8603043242",
"bank_name": "African Bank",
"optional_bank_ref": "ZHKAP",
"payment_amount": "1000",
"bank_account_timeout": "2023-04-06T17:37:42.900Z"
}
}
The user is expected to make the bank transfer within 30 mins of initiating the transaction.
bank_account_timeout
is when the bank account would no longer accept payments for this transaction.optional_bank_ref
is the optional transaction note/reference the user can add to the transaction.bvn (bank verification number)
of the user is required when initiating an NGN transaction. Always confirm the correctness of the bvn provided by sending an OTP to the associated phone number. You can do this with our KYC APIThe minimum
amount
value for NGN is NGN 1000 and the maximum is NGN 10,000,000The user is expected to only make the transfer from a personal bank account belonging to the user.