Skip to main content
Create buy orders with POST /api/developer/orders.
How to read this pageThis is the point where a quote becomes a real transaction. Keep the quote response nearby while you create the order.
When you create a buy 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
Required for buys — amount is the crypto amount, and you also need a destination wallet address:
​
number
required
​
string
required
Optional but useful:
​
string
​
string
​
number
​
boolean

​
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 next-step details you need to show the user.
​
string
​
string
​
string
​
string
​
string
​
string
​
number
​
object
​
string | null
​
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 when it is present.