NGN to USDC - Bridge by LINK

Scenario: Ada wants to buy USDC with ₦50,000. She’ll pay by bank transfer and receive USDC on Solana.


Direction	Onramp
Customer pays	NGN, by bank transfer
Customer receives	USDC on Solana
Limits	₦15,000 to ₦5,000,000
Time to pay	30 minutes

Onboard Ada (once)

curl -X POST https://sandbox.core.linkio.world/api/customers/onboard \
  -H "X-BRIDGE-API-Key: $BRIDGE_API_KEY" \
  -H "API-Version: 2026-10-29-atlas" \
  -H "Content-Type: application/json" \
  -d '{"type":"retail","details":{"first_name":"Ada","last_name":"Obi","email":"ada@example.com","phone":"+2348012345678"}}'

Save id (for example cus_4hT9pL2mQx8VnR3tY7wZ1cB5dE). Skip this step if Ada is already a customer.

Get a quote

curl -X POST https://sandbox.core.linkio.world/api/quotes/generate \
  -H "X-BRIDGE-API-Key: $BRIDGE_API_KEY" \
  -H "API-Version: 2026-10-29-atlas" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "cus_4hT9pL2mQx8VnR3tY7wZ1cB5dE",
    "transaction_type": "onramp",
    "source_amount": "50000",
    "source_currency": "NGN",
    "target_currency": "USDC",
    "payment_method": "bank_transfer",
    "network": "solana"
  }'

Show Ada quote.target_amount (how much USDC she gets). When she confirms, go straight to the next step: the quote lasts about 20 seconds.

Create the onramp

curl -X POST https://sandbox.core.linkio.world/api/payments/onramp \
  -H "X-BRIDGE-API-Key: $BRIDGE_API_KEY" \
  -H "API-Version: 2026-10-29-atlas" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ada-order-77" \
  -d '{
    "customer_id": "cus_4hT9pL2mQx8VnR3tY7wZ1cB5dE",
    "quote_id": "qte_9xLp3VnR7tY1wZ4cB6dE8fK2mQ",
    "payment_details": {
      "type": "stablecoin",
      "currency": "USDC",
      "details": { "address": "6KhMtrKUhYGqVVgV6fcr1Vr1XnQtZCrDwpXTNZHPiReR", "network": "solana" }
    }
  }'

If you get quote_expired, refresh the quote and try again.

Show Ada where to pay

From the response, show:

payment.deposit.details.bank_name
payment.deposit.details.account_number
payment.deposit.details.account_name
payment.deposit.amount_expected: the exact amount to send

Tell her to pay within 30 minutes.

Handle the webhooks

Event	Show Ada
`payment.onramp.fiat_pending`	”Waiting for your transfer.”
`payment.onramp.fiat_received`	”We’ve got your money. Sending your USDC.”
`payment.onramp.completed`	”Done! Your USDC has arrived.”
`payment.onramp.failed`	”We didn’t receive your transfer in time. Please start again.”
`payment.onramp.flagged`	”Your payment is being checked. We’ll update you soon.”

Show the blockchain receipt

After completed, call Get a payment and show Ada the transaction_hash.

Using USDT or another network

Change target_currency to USDT, and network to any supported network. The wallet’s currency and network must match.

​Using USDT or another network

Using USDT or another network