Skip to main content
Create buy orders with POST /api/developer/orders.
How to read this page
This 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

  • side
  • amount
  • fiatCurrency
  • asset
  • chain

​
Buy orders

For buys, amount is the crypto amount and fiatAmount is required. You also need a destination wallet address. Required:
  • fiatAmount
  • walletAddress
Optional but useful:
  • email
  • externalCustomerId
  • developerFeePercent
  • overrideActiveIntent

​
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:
Rules:
  • 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.

​
Response shape

The response includes the tracked RampHub transaction id, the selected provider, and the next-step details you need to show the user. Common fields:
  • transactionId
  • requestReference
  • side
  • asset
  • chain
  • selectedProvider
  • bestRateUsed
  • providerDetails
  • ourCryptoAddress
  • environment
  • sandbox
  • trackable

​
Rules

  • Save transactionId right away.
  • Use providerDetails for the next step.
  • Use ourCryptoAddress when it is present.