Update withdrawal status

PATCH

/v2/send/withdrawals/{withdrawalId}/status

• Staging
• Development

Update the status of a withdrawal (typically called by webhooks)

Authorizations

• X-API-Key
• X-API-Secret

Parameters

Path Parameters

withdrawalId

required

string format: uuid

d24d70a9-e1e2-4e83-ac81-cf62c2cb4c09

Withdrawal ID

Request Body ^required

object

status

required

New status for the withdrawal

string

Allowed values: created networkinprogress networkcompleted networkfailed payoutinprogress payoutcompleted payoutfailed banktransferinprogress banktransfercompleted banktransferfailed completed failed

completed

networkDetails

Network transaction details (e.g., contractTransactionHash, blockNumber, gasUsed)

object

payoutDetails

Payout details (e.g., payoutId, payoutReference, payoutMethod)

object

bankTransferDetails

Bank transfer details (e.g., transferReference, bankCode, clearingDate)

object

failureReason

Failure reason (required when status is failed)

string

Responses

200

The resource has been successfully updated.

object

id

required

Withdrawal ID

string format: uuid

d24d70a9-e1e2-4e83-ac81-cf62c2cb4c09

corridorId

required

Corridor ID

string format: uuid

d24d70a9-e1e2-4e83-ac81-cf62c2cb4c09

organisationId

required

Organisation ID

string format: uuid

d24d70a9-e1e2-4e83-ac81-cf62c2cb4c09

userId

required

User ID

string format: uuid

d24d70a9-e1e2-4e83-ac81-cf62c2cb4c09

status

required

Withdrawal status

string

Allowed values: created networkinprogress networkcompleted networkfailed payoutinprogress payoutcompleted payoutfailed banktransferinprogress banktransfercompleted banktransferfailed completed failed

amount

required

Amount in USDC

string

1000.00

currency

required

Currency code

string

USDC

networkDetails

Network transaction details (e.g., contractTransactionHash, blockNumber, gasUsed)

object

payoutDetails

Payout details (e.g., payoutId, payoutReference, payoutMethod)

object

bankTransferDetails

Bank transfer details (e.g., transferReference, bankCode, clearingDate)

object

failureReason

Failure reason if failed

string

networkCompletedAt

Network completion timestamp

string format: date-time

payoutCompletedAt

Payout completion timestamp

string format: date-time

bankTransferCompletedAt

Bank transfer completion timestamp

string format: date-time

completedAt

Completion timestamp

string format: date-time

createdAt

required

Creation timestamp

string format: date-time

updatedAt

required

Last update timestamp

string format: date-time

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error