Payments

List payments

get

Get a paginated list of payments with optional filtering

Authorizations

OAuth2ClientCredentials

OAuth2applicationRequired

Token URL:

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.

typestring · enumOptional

Filter by payment type

Possible values:

statusstring · enumOptional

Filter by payment status

Possible values:

customer_idstringOptional

Filter by customer ID

invoice_idstringOptional

Filter by invoice ID

payment_methodstring · enumOptional

Filter by payment method

Possible values:

created_at_startstringOptional

Filter by creation date start (RFC3339 format)

created_at_endstringOptional

Filter by creation date end (RFC3339 format)

Responses

200

OK

application/json

400

Bad Request

application/json

get

/payments

HTTPcURLJavaScriptPython

GET /payments HTTP/1.1
Host: public-api.alternativepayments.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

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

Create payment

post

Create a single payment to charge an invoice.

Authorizations

OAuth2ClientCredentials

OAuth2applicationRequired

Token URL:

Body

application/json

Request body for creating a payment

amountstringOptionalExample: 100.00

customer_idstringOptionalExample: 00000000-0000-0000-0000-000000000000

idempotency_keystringOptionalExample: 00000000-0000-0000-0000-000000000000

invoice_idstringOptionalExample: 00000000-0000-0000-0000-000000000000

payment_datestringOptionalExample: 2025-01-01T00:00:000Z

payment_methodstring · enumOptional

@enum card,standard_ach

Possible values:

payment_method_idstringOptionalExample: 00000000-0000-0000-0000-000000000000

Responses

201

Payment is being processed!

application/json

400

Bad Request

application/json

422

Unprocessable Entity

application/json

post

/payments

HTTPcURLJavaScriptPython

POST /payments HTTP/1.1
Host: public-api.alternativepayments.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 303

{
  "amount": "100.00",
  "customer_id": "00000000-0000-0000-0000-000000000000",
  "idempotency_key": "00000000-0000-0000-0000-000000000000",
  "invoice_id": "00000000-0000-0000-0000-000000000000",
  "payment_date": "2025-01-01T00:00:000Z",
  "payment_method": "card",
  "payment_method_id": "00000000-0000-0000-0000-000000000000"
}

text

Get payment by ID

get

Retrieve detailed information about a specific payment

Authorizations

OAuth2ClientCredentials

OAuth2applicationRequired

Token URL:

Path parameters

idstringRequired

Payment ID

Responses

200

OK

application/json

400

Bad Request

application/json

404

Not Found

application/json

get

/payments/{id}

HTTPcURLJavaScriptPython

GET /payments/{id} HTTP/1.1
Host: public-api.alternativepayments.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

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