Place Order

POST /papi/v1/ramp/connect/sandbox/place-order

This endpoint allows you to place test orders in the sandbox environment to simulate the complete order lifecycle without using real funds.

Request Body

Field	Type	Mandatory	Remarks
externalOrderId	string	Yes	The unique order id from the partner side. Supports only letters and numbers.
fiatCurrency	string	Yes	Fiat currency code (e.g., EUR, USD)
cryptoCurrency	string	Yes	Crypto currency code (e.g., USDT, BTC)
requestedAmount	string	Yes	Requested amount. Must be greater than 0 and less than 9999999999999999
amountType	int	Yes	Specify whether the requested amount is in fiat:1 or crypto:2
type	string	Yes	Order type: BUY, BUY_P2P, SEND

Response Body

Field	Type	Remarks
success	boolean	Indicates if the request succeeded
code	string	Response code
message	string	Response message

Example 1: Place a BUY order

Request Parameters:

{
  "externalOrderId": "946972922319",
  "fiatCurrency": "EUR",
  "cryptoCurrency": "USDT",
  "requestedAmount": "100",
  "amountType": 1,
  "type": "BUY"
}

Response:

{
  "success": true,
  "code": "000000",
  "message": "success",
  "data": null
}

Example 2: Place a BUY_P2P order

Request Parameters:

{
  "externalOrderId": "946972922320",
  "fiatCurrency": "USD",
  "cryptoCurrency": "BTC",
  "requestedAmount": "0.5",
  "amountType": 2,
  "type": "BUY_P2P"
}

Response:

{
  "success": true,
  "code": "000000",
  "message": "success",
  "data": null
}

Example 3: Place a SEND order

Request Parameters:

{
  "externalOrderId": "946972922321",
  "fiatCurrency": "EUR",
  "cryptoCurrency": "ETH",
  "requestedAmount": "1.5",
  "amountType": 2,
  "type": "SEND"
}

Response:

{
  "success": true,
  "code": "000000",
  "message": "success",
  "data": null
}