v1

latestOpenAPI 3.0.32026-08-068721.4 KB

Transactions

Approve a pending redemption

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 walletId 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

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.

walletIdstring

Target wallet identifier (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