Skip to main content
POST
/
api
/
user-api
/
card
/
payee
/
pw-card
/
reload
Reload an issued Paywint Card
curl --request POST \
  --url https://api.sandbox.paywint.com/api/user-api/card/payee/pw-card/reload \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <x-api-key>' \
  --header 'X-Api-Secret: <x-api-secret>' \
  --data '
{
  "amount": 50,
  "memo": "Quarterly bonus top-up",
  "payee_card_id": "d9f1a8e7-2f9b-4f39-bc5d-98e01a123456"
}
'
{
  "success": true,
  "message": "Operation completed.",
  "data": {
    "amount": 50,
    "description": "Quarterly bonus top-up",
    "status": "success",
    "transaction_id": "1e5b20d4-58b5-4f2d-a9e5-6c91f0a1c789"
  },
  "queryGeneratedTime": 1718006400
}

Headers

​
X-Api-Key
string
required

Your API Key (UUID format). Required to identify and authorize each request

​
X-Api-Secret
string
required

Secret associated with your API Key. Used for authenticating requests. Keep this secure.

Body

application/json
​
payee_card_id
string<uuid>
required

Unique identifier of the issued Paywint Card that needs to be reloaded.

Example:

"d9f1a8e7-2f9b-4f39-bc5d-98e01a123456"

​
amount
number
required

Amount in USD to add to the issued Paywint Card. This amount will be deducted directly from the issuer’s Paywint wallet balance.

Example:

50

​
memo
string | null

Optional note to associate with the reload transaction. If provided, it will appear in the transaction details.

Example:

"Quarterly bonus top-up"

Response

Successful Response

​
success
boolean
default:true

Indicates whether the request was processed successfully.

Example:

true

​
message
string
default:Success

A short, human-readable message describing the result of the request.

Example:

"Operation completed."

​
data
ExternalGiftCardReloadTransactionRead · object

The main response payload, if applicable

Example:
{
  "amount": 50,
  "description": "Quarterly bonus top-up",
  "status": "success",
  "transaction_id": "1e5b20d4-58b5-4f2d-a9e5-6c91f0a1c789"
}
​
queryGeneratedTime
number | null
default:1771679555.638735

The Unix timestamp (in seconds) indicating when the response was generated.

Example:

1718006400