Withdrawals
Convert USD stablecoins to local African currencies using Direct Ramp withdrawals. This guide covers the complete withdrawal lifecycle, from initiation to settlement.
Withdrawal Flow
Get a valid ramp quote
Initiate withdrawal with quote
Wait for withdrawal to be processed
Mark withdrawal as received
Initiating a Withdrawal
Use initiateRampQuoteWithdrawal
to create a new withdrawal request.
Arguments
rampQuote
ID!
Yes
Quote ID from rampQuote
query
reference
String
No
Your unique reference for reconciliation
mutation {
initiateRampQuoteWithdrawal(
rampQuote: "quote_id"
paymentMethod: "payment_method_id"
reference: "order_123"
) {
id
status
agent
paymentDetails
exchangeRate
amountUsd
amountLocal
}
}
Response
id
ID!
Global ID for the deposit request
status
String!
Current status (see Status Lifecycle)
agent
String!
Assigned payout agent
paymentDetails
String!
User's payout instructions (bank details, mobile money number)
exchangeRate
Decimal!
Locked FX rate for this withdrawal
amountLocal
Decimal!
Amount in local currency
amountUsd
Decimal!
Amount in USD stablecoins
Status Lifecycle
picked_up
Initial state
Awaiting payout
completed
Funds settled
Customer received funds
canceled
Manually canceled
-
Marking as Received
Use markWithdrawalAsReceived
to allow your customer to indicate that they have received the funds.
Arguments
paymentRequest
ID!
Yes
Withdrawal request ID
mutation {
markWithdrawalAsReceived(paymentRequest: "withdrawal_id")
}
Last updated