post
https://crypto.honeycoin.app/api/minting/onramp
Convert fiat currency into USDC or USDT through mobile money, bank transfer, or OPay and settle it to an on-chain wallet address.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
OPay Onramp
To collect NGN through OPay, set method to opay and provide:
| Field | Required | Description |
|---|---|---|
senderCurrency | ✅ | Set to NGN |
chargeDetails.email | ✅ | Customer email for the OPay payment |
successRedirectUrl | ❌ | URL to return the customer to after successful authorization |
failureRedirectUrl | ❌ | URL to return the customer to after failed authorization |
{
"senderAmount": 5000,
"senderCurrency": "NGN",
"receiverCurrency": "USDC",
"chain": "BASE",
"receiverAddress": "0xbac726e1df4dd58ca13bf6b9f23664df5d07d2fe",
"method": "opay",
"chargeDetails": {
"email": "[email protected]"
},
"externalReference": "onramp_opay_001",
"successRedirectUrl": "https://yourapp.example/onramp/success",
"failureRedirectUrl": "https://yourapp.example/onramp/failed"
}An OPay initiation can return either an actionable redirect or a pending state.
{
"success": true,
"data": {
"transactionId": "y47aWLwUE2NW7duNNbiM",
"stepRequired": "redirect",
"redirectUrl": "https://checkout.example.com/opay/authorize"
}
}{
"success": true,
"data": {
"transactionId": "y47aWLwUE2NW7duNNbiM",
"status": "PENDING",
"chargeStatus": "pending"
}
}When stepRequired is redirect, send the customer to data.redirectUrl. Always verify that chargeStatus becomes successful through a webhook or the get transaction endpoint before providing value.
In sandbox, every valid OPay onramp returns a redirect. Amount 111 succeeds after that redirect is completed; amount 999 and every other amount fail.