Onramp
Accept NGN and deliver crypto in three API calls.
An onramp accepts NGN from the customer and delivers crypto to a wallet. You need a test API key.
Pulse delivers to your customer's wallet. If your business pays out only to its own accounts, Pulse delivers to a payout account instead. See Name a payout account on an order.
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 in payer. Then name the wallet that receives the crypto.
Send the customer's wallet in destination.
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.