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 test 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",
"source_amount": "150000"
}'Your integration must store data.id. The quote expires after two minutes. You can
refresh the quote if the customer needs more time.
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": "partner-order-88213",
"quote_id": "0198e2c1-…",
"payer": {
"name": "Ada Obi",
"email": "ada@example.com",
"nin": "12345678901",
"bvn": "22345678901"
},
"destination": {
"address": "0xAbC0000000000000000000000000000000000000"
}
}'The response contains data.funding_account. Show its bank details and exact amount
to the customer. The order remains payable for 30 minutes from the moment the account
is issued, until data.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. The test environment advances ordinary orders automatically. Use the
reserved values in Testing to test other outcomes.
See Orders for response fields and status rules.