/api/partner/v1/on-ramp

Headers

x-supported-country - Country code of the flow (MX or DO)

PartnerApiKey (string) - API key associated with the partner.

🚧

Partner API Key Required

Requires partner-api-key for authentication to ensure only authorized partners can access this data.

See 🔑 API Key Generation Guide for getting your API key

Parameters

• fromAmount (number) - The amount of fiat money to be exchanged. The amount of crypto to be received can be calculated with the On Ramp Quoter
• fiatCurrencyId (string) - Refers to the fiat currency id for on-ramp transactions. See Fiat docs for more information on how to retrieve the fiat currency id.
• userWalletAddress (string) - Refers to the user where the crypto will be sent to, make sure that it is an EVM Wallet since this is the only type of wallets we support for now
• blockchainToTokenId (string) - Refers to the blockchain-to-token id for on-ramp transactions. See Blockchain to Token docs for more information on how to retrieve the Blockchain to token id.
• userId (string) - Id from the user the transaction is going to be created on behalf of

Response Body

• id(string) - Transaction Id
• userId(string) - Id from the user the transaction was created on behalf of
• status (string) - The status of the transaction which at the time of the creation should equal to PENDING
• fromAmount (number) - The amount of fiat currency being converted.
• fiatCurrencyId (string) - The id of the fiat being exchanged from.
• blockchainToTokenId(string) - The id of the blockchainToToken.
• type - Type of transaction ON_RAMP or OFF_RAMP

Example

{
  id: "a1b2c3d4-e5f6-7g8h-9i0j-k1l2m3n4o5p6",
  userId: "8f48c371-24e5-4f63-9589-f4f1d2921635",
  status: "PENDING",
  fromAmount: 1000.00,
  fiatCurrencyId: "dd4f872b-3221-4a20-8eff-80149278ec35"
	blockchainToTokenId: "2ede30c1-4c9c-4a07-a402-f525f0a52e77"
  type: "ON_RAMP
}

Use Cases

• Execute On-Ramp Transaction: Create on ramp transaction in behalf of a user with the parameters selected.