Skip to main content
POST
/
api
/
v1
/
business-onramp
/
create
Create Onramp Order
curl --request POST \
  --url https://aboki-b2b-eobk.onrender.com/api/v1/business-onramp/create \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '{
  "customerEmail": "<string>",
  "customerName": "<string>",
  "customerPhone": "<string>",
  "amount": 123,
  "targetToken": "<string>",
  "targetNetwork": "<string>",
  "customerWallet": "<string>",
  "redirectUrl": "<string>",
  "webhookUrl": "<string>",
  "metadata": {}
}'
{
  "success": true,
  "data": {
    "orderId": "<string>",
    "targetNetwork": "<string>",
    "tokenInfo": {},
    "smartContractData": {},
    "jupiterData": {},
    "paymentInstructions": {}
  }
}

​
Create Onramp Order

Create a new onramp order for converting NGN to crypto tokens. Works across Base, Solana, and Ethereum networks with automatic validation and transaction preparation.
​
Authorization
string
required
Your Public Key from the dashboard. Format: Bearer pk_live_your_key_here
​
Content-Type
string
required
Always use: application/json

​
Body Parameters

​
Customer Information

​
customerEmail
string
required
Customer’s email address (e.g., customer@example.com)
​
customerName
string
required
Customer’s full name (e.g., John Doe)
​
customerPhone
string
required
Customer’s phone number with country code (e.g., +234-123-456-7890)

​
Transaction Details

​
amount
number
required
NGN amount customer wants to spend (e.g., 50000 for ₦50,000)
​
targetToken
string
required
Token symbol customer wants to receive (e.g., ENB, USDC, ETH, SOL)
​
targetNetwork
string
required
Blockchain network: base, solana, or ethereum
​
customerWallet
string
required
Customer’s wallet address to receive tokens (e.g., 0x742d35Cc6634C0532925a3b8D1D8ce28D2e67F5c)

​
Optional Parameters

​
redirectUrl
string
URL to redirect customer after payment completion
​
webhookUrl
string
URL to receive order status updates
​
metadata
object
Additional data for your reference (userId, source, etc.)

​
Response

​
success
boolean
Whether the order was created successfully
​
data
object
​
orderId
string
Unique order identifier (e.g., OR_1234567890_ABCDEF)
​
targetNetwork
string
Blockchain network for the transaction
​
tokenInfo
object
Information about the target token
​
smartContractData
object
Base network smart contract information (if applicable)
​
jupiterData
object
Solana Jupiter DEX information (if applicable)
​
paymentInstructions
object
Instructions for customer NGN payment

​
Example Response

{
  "success": true,
  "message": "Onramp order created successfully for ENB on base",
  "data": {
    "orderId": "OR_1234567890_ABCDEF",
    "targetNetwork": "base",
    "tokenInfo": {
      "symbol": "ENB",
      "network": "base",
      "finalAmount": 123.74
    },
    "smartContractData": {
      "liquidityAdequate": true,
      "transactionPreparation": {
        "success": true,
        "transactionId": "tx_abc123"
      }
    },
    "paymentInstructions": {
      "amount": 50000,
      "accountDetails": "Contact support for payment details",
      "reference": "OR_1234567890_ABCDEF"
    }
  }
}
⌘I