Onramp
Accept NGN and deliver crypto in three API calls.
An onramp accepts NGN from the customer and delivers crypto to the wallet address you provide. You need a pilot API key.
Get an NGN-to-crypto quote
curl https://engine-api.pilot.pulseshiga.io/v1/quotes \
-H "X-API-Key: <your key>" \
-H "Content-Type: application/json" \
-d '{
"source_currency": "NGN",
"destination_currency": "USDT",
"network": "POLYGON",
"amount": "150000"
}'Save data.id. The quote expires after 10 minutes and can create one order.
Create the onramp order
Set a unique reference that identifies this payment in your system. Send the
customer's identity and the wallet that will receive the crypto.
curl https://engine-api.pilot.pulseshiga.io/v1/onramp/orders \
-H "X-API-Key: <your key>" \
-H "Content-Type: application/json" \
-d '{
"reference": "piggy-txn-88213",
"quote_id": "0198e2c1-…",
"payer": {
"name": "Ada Obi",
"email": "ada@example.com",
"nin": "12345678901",
"bvn": "22345678901"
},
"destination": {
"address": "0xAbC0000000000000000000000000000000000000"
}
}'The response contains data.account. Show its bank details and exact amount to
the customer. The virtual account remains valid for 30 minutes, until
account.expires_at.
Track the order
curl https://engine-api.pilot.pulseshiga.io/v1/orders/0198e2d0-… \
-H "X-API-Key: <your key>"Poll with backoff or consume webhooks. Stop at completed, expired,
or failed. Pilot advances ordinary orders automatically; use the reserved values
in Testing on pilot to test other outcomes.
See Orders for response fields and status rules.