Skip to navigation

Generate Quote to Mobile Wallet

View as Markdown

Generates a payment quote for an off-ramp transaction to a Colombian mobile wallet (e.g. Nequi, DaviPlata).

Calculates the conversion from USDT (Tron or Polygon network) to COP for the specified amount and recipient’s mobile wallet. The quote must be accepted before the payment is processed.

Authentication: Bearer token ({{JWT_LOGIN}}) + x-api-key header.

Key body fields

  • transactionId: Unique identifier for the transaction.

  • baseCurrency / quoteCurrency: Source and target currencies (e.g. USDT → COP).

  • amount: Amount in the base currency to convert.

  • blockchainNetwork: Blockchain used to fund the payment (e.g. Tron, Polygon).

  • requirements.paymentMethod: Must be MobileWallet.

  • requirements.mobileWallet: Wallet details including name (e.g. Nequi) and number (phone number).

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Headers

x-api-keystringOptional

Request

This endpoint expects an object.
transactionIdstringRequiredformat: "uuid"
descriptionstringRequired
baseCurrencystringRequired
quoteCurrencystringRequired
amountintegerRequired
blockchainNetworkstringRequired
recipientobjectRequired

Response headers

x-amzn-RequestIdstringOptional
Access-Control-Allow-OriginstringOptional
x-amz-apigw-idstringOptional
X-Amzn-Trace-IdstringOptional

Response

OK
transactionIdstringformat: "uuid"
addressstring
blockchainNetworkstring
quoteobject
recipientobject