Skip to main content
Create sell orders with POST /api/developer/orders. When you create a sell order, RampHub also creates the matching order intent automatically. If you need to show the active payment window or let support extend it, see Order intent. If the same customer, token, and network already has an active order window, RampHub returns a structured PAYCHAIN_ACTIVE_INTENT_CONFLICT response. Your app can use the Order intent endpoint to show the current window first, or resend the order with overrideActiveIntent: true if the customer wants to replace it.

​
Request body

Required on every order:
​
string
required
​
number
required
​
string
required
​
string
required
​
string
required
For sells, send resolved bank details instead of walletAddress:
​
string
required
​
string
required
​
string
required
Optional but useful:
​
string
​
string
​
string
​
number
​
boolean
If you need to render the accepted banks for a specific provider before the user submits the order, call Provider bank list and use the returned bankCode values in the sell form. If you do not already have the account holder name, call POST /api/developer/bank-accounts/resolve first and reuse the returned accountName.

​
Business fees

RampHub lets businesses attach a developer fee percent to the same order request. RampHub accrues the fee internally, so you only need the percentage:

​
Response shape

The response includes the tracked RampHub transaction id, the selected provider, and the provider settlement details your app should show next.
​
string
​
string
​
string
​
string
​
string
​
string
​
number
​
object
​
string
​
string
​
boolean
​
boolean

​
Notes

  • Save transactionId right away.
  • Use providerDetails for the next step.
  • developerFeePercent can be 0 or a small percentage like 0.5.
  • overrideActiveIntent can be set to true when the customer wants to replace an existing active order window.
  • Use ourCryptoAddress for sell payment instructions when it is present.