Initiates a token redemption process

post

https://stage.buildwithjuno.com/mint_platform/v1/redemptions

Initiates the asynchronous redemption process to convert blockchain tokens (e.g., MXNB) back to fiat assets (MXN).

This endpoint processes the conversion of tokenized assets back to their underlying fiat currency. The process includes:

Burning the blockchain tokens from the user's wallet
Converting them back to the equivalent fiat amount
Transferring the fiat currency to the specified destination

Amount Requirements:

The amount must be equal to or higher than 100.00 MXN for the request to be processed

Transfer Behavior:

If destination_bank_account_id is provided: MXN is transferred via SPEI to the specified bank account
If destination_bank_account_id is not provided: MXN is transferred to the user's account with no SPEI transfer

Note: This is an asynchronous process. The endpoint returns immediately with a transaction ID, but the actual redemption processing happens in the background. Use the transaction ID to track the status of the redemption.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

A DTO representing a redemption request.

amount

double

required

100 to 10000000

The amount to be redeemed. Must be between 100.00 and 10,000,000 MXN, inclusive, with up to two decimal places.
The maximum limit of 10,000,000 MXN is enforced due to a soft limit on the SPEI withdrawal ramp.
This limit is set by the platform by default, although it can be manually increased—up to 200,000,000 MXN—via the admin dashboard
by adjusting the limit for a specific user. Since the default limit is 10 million and users are unlikely to transact amounts above
this threshold in a single operation, this validation prevents redemptions that exceed 10,000,000 MXN, avoiding the failure and refund process altogether.

destination_bank_account_id

uuid

The UUID of the destination bank account. This field is optional.
If provided, the MXN will be transferred via SPEI to the specified bank account.
If not provided, the MXN will be transferred to the user's account and there will be no SPEI transfer.

asset

string

enum

required

^MXN$

The asset to be redeemed. Must not be blank and must match "MXN". Currently, only "MXN" is supported for redemption.

Allowed:

Headers

X-Idempotency-Key

string

length ≤ 36

Idempotency key to ensure request uniqueness.

Responses

401

Unauthorized access.

500

Internal server error.

202Redemption request accepted.

400Invalid request.