Transactions

Approve a pending redemption

Changed on Sep 18, 2026

Approves a transaction held in PENDING status (flexible redemption) and directs it. Set type to FIAT to settle to your default bank account (creates a REDEMPTION), or to CRYPTO with a walletRipId to bridge to one of your wallets (creates a BRIDGE).

Re-submitting the same destination after the transaction has moved to PROCESSING is idempotent and returns 200. Submitting a different destination, or approving a transaction that was never PENDING, returns 409.

put/v1/stablecoin/transactions/{id}/destination

Request

Base URL
https://api.ripple.com
Auth
OAuth 2
Client credentials
Token URLhttps://api.ripple.com/v2/oauth/token
Scopesrlusd_customers:write
TypeScript
https://skmtc.dev/ripple/apis/ripple-mint-api/docs/v1/stablecoin/transactions/:id/destination/put.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

idstring uuid required

Transaction UUID

Request body

type'FIAT' | 'CRYPTO' required

Destination type. FIAT creates a REDEMPTION settled to your default bank account; CRYPTO creates a BRIDGE transfer to one of your wallets.

walletRipIdstring

Target wallet ripId (e.g. RIP0000001). Required when type is CRYPTO; must be omitted when type is FIAT.

Response

Updated transaction, transitioned to PROCESSING with type/destination populated

idstring uuid required

Unique transaction identifier

type'ISSUANCE' | 'REDEMPTION' | 'BRIDGE' nullable

Transaction type. Null while the transaction is PENDING (flexible redemption) and a destination has not yet been chosen.

status'PROCESSING' | 'PENDING' | 'COMPLETED' | 'FAILED' | 'CANCELED' required

Current transaction status. COMPLETED, FAILED, and CANCELED are terminal. CANCELED currently applies to ISSUANCE transactions canceled before settlement. PENDING applies to flexible-redemption transactions awaiting approval via Approve a pending redemption; type and destination are null until approved.

amountstring required

Transaction amount as a decimal string (e.g. "10000.00")

token'RLUSD' required

Always RLUSD

createdAtstring date-time required

Timestamp when the transaction was created

updatedAtstring date-time required

Timestamp when the transaction was last updated

Example response

{
  "source": {
    "memo": "RL7Q3K9ZP2MTX4VB"
  },
  "destination": {
    "memo": "RL7Q3K9ZP2MTX4VB"
  }
}

Changes

Sep 18, 20266db752579872 Revision changes
- warning
  added the new FIAT_INSTRUCTION_ALREADY_EXISTS enum value to the response property for the response status
- warning
  added the new FIAT_INSTRUCTION_ALREADY_EXISTS enum value to the response property for the response status
- warning
  added the new FIAT_INSTRUCTION_ALREADY_EXISTS enum value to the response property for the response status
- warning
  added the new FIAT_INSTRUCTION_ALREADY_EXISTS enum value to the response property for the response status
- warning
  added the new FIAT_INSTRUCTION_ALREADY_EXISTS enum value to the response property for the response status
- warning
  added the new FIAT_INSTRUCTION_ALREADY_EXISTS enum value to the response property for the response status
- warning
  added the new FIAT_INSTRUCTION_INVALID_STATUS_TRANSITION enum value to the response property for the response status
- warning
  added the new FIAT_INSTRUCTION_INVALID_STATUS_TRANSITION enum value to the response property for the response status
- warning
  added the new FIAT_INSTRUCTION_INVALID_STATUS_TRANSITION enum value to the response property for the response status
- warning
  added the new FIAT_INSTRUCTION_INVALID_STATUS_TRANSITION enum value to the response property for the response status
- warning
  added the new FIAT_INSTRUCTION_INVALID_STATUS_TRANSITION enum value to the response property for the response status
- warning
  added the new FIAT_INSTRUCTION_INVALID_STATUS_TRANSITION enum value to the response property for the response status
- warning
  added the new FIAT_INSTRUCTION_NOT_FOUND enum value to the response property for the response status
- warning
  added the new FIAT_INSTRUCTION_NOT_FOUND enum value to the response property for the response status
- warning
  added the new FIAT_INSTRUCTION_NOT_FOUND enum value to the response property for the response status
- warning
  added the new FIAT_INSTRUCTION_NOT_FOUND enum value to the response property for the response status
- warning
  added the new FIAT_INSTRUCTION_NOT_FOUND enum value to the response property for the response status
- warning
  added the new FIAT_INSTRUCTION_NOT_FOUND enum value to the response property for the response status
- warning
  added the new FORBIDDEN enum value to the response property for the response status
- warning
  added the new FORBIDDEN enum value to the response property for the response status
- warning
  added the new FORBIDDEN enum value to the response property for the response status
- warning
  added the new FORBIDDEN enum value to the response property for the response status
- warning
  added the new FORBIDDEN enum value to the response property for the response status
- warning
  added the new FORBIDDEN enum value to the response property for the response status
- warning
  added the new STABLECOIN_BANK_DETAILS_NOT_FOUND enum value to the response property for the response status
- warning
  added the new STABLECOIN_BANK_DETAILS_NOT_FOUND enum value to the response property for the response status
- warning
  added the new STABLECOIN_BANK_DETAILS_NOT_FOUND enum value to the response property for the response status
- warning
  added the new STABLECOIN_BANK_DETAILS_NOT_FOUND enum value to the response property for the response status
- warning
  added the new STABLECOIN_BANK_DETAILS_NOT_FOUND enum value to the response property for the response status
- warning
  added the new STABLECOIN_BANK_DETAILS_NOT_FOUND enum value to the response property for the response status
- warning
  added the new UPSTREAM_UNAVAILABLE enum value to the response property for the response status
- warning
  added the new UPSTREAM_UNAVAILABLE enum value to the response property for the response status
- warning
  added the new UPSTREAM_UNAVAILABLE enum value to the response property for the response status
- warning
  added the new UPSTREAM_UNAVAILABLE enum value to the response property for the response status
- warning
  added the new UPSTREAM_UNAVAILABLE enum value to the response property for the response status
- warning
  added the new UPSTREAM_UNAVAILABLE enum value to the response property for the response status
- warning
  added the new WALLET_NOT_APPROVED enum value to the response property for the response status
- warning
  added the new WALLET_NOT_APPROVED enum value to the response property for the response status
- warning
  added the new WALLET_NOT_APPROVED enum value to the response property for the response status
- warning
  added the new WALLET_NOT_APPROVED enum value to the response property for the response status
- warning
  added the new WALLET_NOT_APPROVED enum value to the response property for the response status
- warning
  added the new WALLET_NOT_APPROVED enum value to the response property for the response status
- warning
  added the new WALLET_NOT_FOUND enum value to the response property for the response status
- warning
  added the new WALLET_NOT_FOUND enum value to the response property for the response status
- warning
  added the new WALLET_NOT_FOUND enum value to the response property for the response status
- warning
  added the new WALLET_NOT_FOUND enum value to the response property for the response status
- warning
  added the new WALLET_NOT_FOUND enum value to the response property for the response status
- warning
  added the new WALLET_NOT_FOUND enum value to the response property for the response status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
Sep 11, 2026ac589c8a68bb Revision changes
- warning
  removed the request property
- warning
  removed the optional property ///// from the response with the status
- warning
  removed the optional property / from the response with the status
- info
  added the new optional request property
- info
  added the optional property ///// to the response with the status
- info
  added the optional property / to the response with the status

Operation history