User

Transactions history

Changed on

This GET endpoint is used to retrieve a list of all transactions, including payouts, loads, and spendbacks, for a provided user with the provided user token. <br> payout entries cover both the payouts paid to the user and the payouts the user sent (initiated with the user's token as sender_user_token); an entry of a payout the user sent names the payee in user_token and the user in sender_user_token. <br> You can use this endpoint to obtain a comprehensive history of transactions for the provider user, allowing you to track and analyze their payment activities over time. <br> To use this endpoint, you need to provide the user_token as a parameter in the URL Path. <br> The response will contain a JSON array of transaction objects, each including transactions details.

get/payout/user/{user_token}/transactions

Request

Query parameters

number_of_recordsnumber

Number of records to return. Defaults to 10 if no value is provided

start_datestring date
Example:2020-03-31

Starting date

end_datestring date
Example:2020-03-31

Ending date

pageinteger

Page number

type'payout' | 'load' | 'spendback' | 'payin'
Example:payout

Filter particular types of transactions. Comma separated to include multiple types

wallet_tokenstring uuid

Filter transactions to include only provided wallet token.

show_all_clientsboolean

Whether to show transactions from all clients

Headers

Idempotency-Keystring

Unique key to prevent duplicate processing

Response

Succesful operation.

Example response

{
  "transactions": [
    {
      "token": "123e4567-e89b-12d3-a456-426614174000",
      "type": "payout",
      "source_amount": 50.1,
      "source_currency_code": "USD",
      "destination_amount": 44.99,
      "fee": 2.98,
      "status": "READY_FOR_PICKUP",
      "notes": "Purchase of Candles. Order #14930",
      "payer_name": "Elektra",
      "pickup_code": "343432",
      "source_token": "123e4567-e89b-12d3-a456-426614174000",
      "destination_token": "123e4567-e89b-12d3-a456-426614174000",
      "sender_user_token": "usr_7f8e9d0c-1b2a-4c3d-9e5f-6a7b8c9d0e1f",
      "sender_first_name": "John",
      "sender_last_name": "Doe",
      "sender_business_name": "Acme Inc."
    }
  ]
}

Changes

    • warning

      added the new RETURNED enum value to the // response property for the response status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status