cURL
Cross-Ramp
Create Cross-Ramp Quote
POST
cURL
Creates a locked cross-ramp quote with a guaranteed exchange rate. Pass the returned
quoteId when creating a cross-ramp transaction.
Field Relationships
- Provide either
sourceAmountortargetAmount, not both.
Important Notes
- Quotes expire — check the
expiresAtfield and create the transaction before it lapses. - Pass the returned
quoteIdto Create Cross-Ramp. - To quote a USD payout to China (CN) or Hong Kong (HK), pass
targetCountry: "CN"(or"HK") and optionallytargetRail(LOCALdefault, orSWIFT). See the Cross-Ramp guide.
Error Codes
Common Errors
| HTTP Status | Code | Message |
|---|---|---|
| 401 | UNAUTHORIZED | ”API Key is missing” |
| 401 | UNAUTHORIZED | ”Invalid API Key format” |
| 401 | UNAUTHORIZED | ”Invalid API Key” |
| 403 | INVALID_PARTNER_FLOW | ”The partner has an invalid flow.” |
Endpoint-Specific Errors
| HTTP Status | Code | Message |
|---|---|---|
| 400 | INVALID_USER_INPUT_ERROR | ”Invalid User Input” |
| 400 | BAD_REQUEST | ”Requested fiat currency is invalid or inactive” |
| 500 | INTERNAL_SERVER_ERROR | ”Failed to create quote” |
Authorizations
API key for the affiliated partner performing the request.
Body
application/json
The source fiat currency symbol
Available options:
MXN, DOP, USD, EUR Example:
"MXN"
The target fiat currency symbol
Available options:
MXN, DOP, USD, EUR Example:
"USD"
The amount of source fiat currency to convert
The desired amount of target fiat currency to receive
Spread percentage to be applied to the exchange rate
Target country. Required to quote a USD payout to China (CN) or Hong Kong (HK), since USD otherwise defaults to the US.
Available options:
MX, DO, US, AT, BE, BG, HR, CY, CZ, DK, EE, FI, FR, DE, GR, HU, IE, IT, LV, LT, LU, MT, NL, PL, PT, RO, SK, SI, ES, SE, IS, LI, NO, CH, GB, MC, SM, AD, VA, CN, HK Target payment rail for CN/HK destinations. Defaults to LOCAL; use SWIFT for an international wire.
Available options:
LOCAL, SWIFT