Card Withdrawal

Withdraws funds from a card back to user's account.

Endpoint: POST /{san}/withdraw

Path Parameters:

  • san - Secure Account Number (card identifier)

Content-Type: application/json

Request Body:

{
  "request_id": "request-id-12345",
  "currency": "USD",
  "amount": 3.82
}

Request Parameters:

Field
Type
Required
Constraints
Description

request_id

String

Yes

12-36 characters

Unique request identifier

currency

String

Yes

USD, EUR

Currency code (must match card currency)

amount

Decimal

Yes

> 0.01

Amount to withdraw

Response:

{
  "status": "INPROCESS",
  "type": "WITHDRAWAL",
  "docid": 216544,
  "request_id": "request-id-12345",
  "withdrawal": {
    "san": "90ce74932027804177",
    "amount": 3.82,
    "currency": "USD"
  },
}

Response Parameters:

Field
Type
Description

type

String

Operation type (WITHDRAWAL)

status

String

Current status of the operation

(INPROCESS, EXECUTED, DECLINED)

docid

Number

Document ID for tracking the operation

request_id

String

The request ID provided in the request

withdrawal

Object

Withdrawal operation details

withdrawal.san

String

Secure Account Number (card identifier)

withdrawal.amount

Decimal

Amount withdrawn from the card

withdrawal.currency

String

Currency code (USD, EUR, etc.)

Last updated