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.)