Checking the status of a transfer

Get the transfer ID

Make sure you have the transfer ID ready. When you create a transfer, you receive a transfer ID in the response. This unique identifier allows you to check the status of a specific transfer or perform other operations on it.

For this guide, we'll use the transfer ID tr_VPPxwtnOQuOO3ItMTL.

Make the API request

Call the GET /v1/transfers/{id} endpoint using the following format:

curl https://wallet.swipelux.com/v1/transfers/tr_VPPxwtnOQuOO3ItMTL \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_SECRET_API_KEY'

Handle the response

The API will return a JSON response containing the transfer details:

{
  "id": "tr_VPPxwtnOQuOO3ItMTL",
  "onBehalfOf": "cus_cK69MttD5nAUAbud1B",
  "state": "awaiting_funds",
  "amount": "100",
  "source": {
    "currency": "USD",
    "paymentRail": "card"
  },
  "destination": {
    "currency": "USDC"
  },
  "createdAt": "2025-04-29T12:17:56.954Z",
  "updatedAt": "2025-04-29T12:17:56.954Z"
}

The state field indicates the current status of the transfer. In this case, awaiting_funds means the transfer is waiting for the customer to complete their payment.