Payouts

List payouts

get

Get a paginated list of payouts with optional filtering

Authorizations

BearerAuth

AuthorizationstringRequired

Provide your access token returned from /oauth/token prefixed with Bearer. Example: Authorization: Bearer YOUR_TOKEN

Query parameters

limitintegerOptional

Number of items to return

afterstringOptional

Specifies the cursor after which to start returning results. For the first page, this should be left empty. For subsequent pages, use the value of the end_cursor field from the previous response.

beforestringOptional

Specifies the cursor before which to return results. Use this to paginate backwards. For example, to load the previous page, provide the value of the start_cursor field from the last response.

statusstring · enumOptional

Filter by payout status

Possible values:

customer_idstringOptional

Filter by customer ID

invoice_idstringOptional

Filter by invoice ID

start_datestringOptional

Filter by start date (RFC3339 format)

end_datestringOptional

Filter by end date (RFC3339 format)

Responses

200

OK

application/json

400

Bad Request

application/json

get

/payouts

HTTPcURLJavaScriptPython

GET /payouts HTTP/1.1
Host: public-api.alternativepayments.io
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "arrival_date": "text",
      "created_at": "text",
      "customer_id": "text",
      "fees": [
        {
          "amount": 1,
          "covered_by_customer": true,
          "name": "text",
          "type": "unspecified"
        }
      ],
      "id": "text",
      "status": "unspecified",
      "sub_total": 1,
      "total": 1
    }
  ],
  "end_cursor": "gaFpxBACEaXBVABEYbHG+X9LyLnH",
  "has_next_page": true,
  "has_previous_page": false,
  "start_cursor": "gaFpxBACEaXBVABEYbHG+X9LyLnH"
}

Get a payout

get

Get payout details by ID

Authorizations

BearerAuth

AuthorizationstringRequired

Provide your access token returned from /oauth/token prefixed with Bearer. Example: Authorization: Bearer YOUR_TOKEN

Path parameters

idstringRequired

Payout ID

Responses

200

OK

application/json

404

Not Found

application/json

get

/payouts/{id}

HTTPcURLJavaScriptPython

GET /payouts/{id} HTTP/1.1
Host: public-api.alternativepayments.io
Authorization: YOUR_API_KEY
Accept: */*

{
  "arrival_date": "text",
  "created_at": "text",
  "customer_id": "text",
  "fees": [
    {
      "amount": 1,
      "covered_by_customer": true,
      "name": "text",
      "type": "unspecified"
    }
  ],
  "id": "text",
  "status": "unspecified",
  "sub_total": 1,
  "total": 1
}

Get a payout transactions

get

Get payout transactions by ID

Authorizations

BearerAuth

AuthorizationstringRequired

Provide your access token returned from /oauth/token prefixed with Bearer. Example: Authorization: Bearer YOUR_TOKEN

Path parameters

idstringRequired

Payout ID

Responses

200

OK

application/json

404

Not Found

application/json

get

/payouts/{id}/transactions

HTTPcURLJavaScriptPython

GET /payouts/{id}/transactions HTTP/1.1
Host: public-api.alternativepayments.io
Authorization: YOUR_API_KEY
Accept: */*

{
  "payout": {
    "arrival_date": "text",
    "created_at": "text",
    "customer_id": "text",
    "fees": [
      {
        "amount": 1,
        "covered_by_customer": true,
        "name": "text",
        "type": "unspecified"
      }
    ],
    "id": "text",
    "status": "unspecified",
    "sub_total": 1,
    "total": 1
  },
  "transactions": [
    {
      "description": "text",
      "direction": "credit",
      "failure_reason": "text",
      "id": "text",
      "method": "standard_ach",
      "status": "created",
      "sub_total": 1,
      "total": 1
    }
  ]
}