Get a collection of payments

get/payments

The GET /payments call allows your platform to look up a collection of payments.

SecurityappIdAuth and appTokenAuth
Request
query Parameters
page
string

Return elements from this page.

page_size
integer [ 1 .. 50 ]
Default: 10

Return no more than this many elements per page. If not specified, page_size defaults to 10. Maximum value allowed is 50.

create_time_start
integer <int64> >= 0

The timestamp for the start of the search window.

create_time_end
integer <int64> >= 0

The timestamp for the end of the search window.

minimum_amount
integer

Define the minimum value of the amount value for returned Payments (inclusive).

maximum_amount
integer

Define the maximum value of the amount value for returned Payments (inclusive).

owner_id
string

ID of the owner of the resource.

payment_method_type
string

Type of the payment method used. Possible values include: credit_card, payment_bank_ca, payment_bank_us.

Enum: Description
credit_card

This value is required if the credit_card structure is being sent with raw credit card data.

payment_bank_us

This value is required if the payment_bank_us structure is being sent with the raw bank account data.

… 1 more
payment_method_id
string

ID of the payment method used, generated by WePay when the payment method is created.

status
string

Status of the payment. Possible values include: pending, completed, failed, canceled.

Enum: Description
pending

This payment is processing, but is not yet included in the account's available or reserve balance. Find more information in the pending_reasons structure.

completed

This payment has finished processing, and is now available in either the account's available or reserved balance. Note: A payment can have a completed status and simultaneously have a refund or dispute issued against it.

… 2 more
reference_id
string

The reference_id to search for.

header Parameters
Api-Version
required
string
Example: 3.0
Unique-Key
string
Responses
200
Response Schema: application/json
previous
required
string or null
next
required
string or null
required
Array of objects
api_version
string
400

INVALID_PARAMS

403

NOT_AUTHORIZED

500

UNEXPECTED_ERROR

Request samples
Response samples
application/json
{
  • "next": "/payments?page=QVFQNUFBRVhpWFpzUGwxdncxNXN5bFgxUWhOd2RkNjJjWjYvdXFkNTFwZFowYi9EM2hJS25IRVBpS1NybkwrSWRIZE9vd00xZjNsQ1Q4ZUlJTVJTd0VmVnVXd3VxK2N1MHJ3RUUrL0VFVXRneUFxTG41TW5lcUxxRGRtd2YvODlMbjdnamk2S21qSDBhRkVsYW1EMGZUalljVVFHUThjWTB2Rm1lbUdxd3R0WjVjZEFPejUyWU1sOGdTTXRWUT09",
  • "previous": null,
  • "api_version": "3.2",
  • "results": [
    • {
      • "amount": 1000,
      • "amount_refunded": 1000,
      • "amount_disputed": 1000,
      • "auto_capture": false,
      • "capture_at": null,
      • "create_time": 1510080179,
      • "currency": "USD",
      • "custom_data": null,
      • "failure_reason": null,
      • "fee_amount": 0,
      • "fee_amount_refundable": 0,
      • "id": "00000000-0000-0000-0000-0000767bf5cd",
      • "order": null,
      • "owner": {
        • "id": "be2b42e5-b808-40ae-9bbe-3291ab493f57",
        • "path": "/accounts/be2b42e5-b808-40ae-9bbe-3291ab493f57",
        • "resource": "accounts"
        },
      • "path": "/payments/00000000-0000-0000-0000-0000767bf5cd",
      • "payment_method": {
        • "id": "00000000-6363-0000-0000-000008b93a6e",
        • "path": "/payment_methods/00000000-6363-0000-0000-000008b93a6e",
        • "resource": "payment_methods"
        },
      • "pending_reasons": [
        • {
          • "details": [ ],
          • "reason_code": "PENDING_CAPTURE",
          • "reason_message": "Payment pending capture."
          }
        ],
      • "resource": "payments",
      • "status": "pending",
      • "authorization_code": "0224241",
      • "txnr_app_fee": null,
      • "txnr_merchant": null,
      • "initiated_by": "none",
      • "api_version": "3.2",
      • "reference_id": "dfeb052b-ae8c-4a69-b909-8d9ecdd7c742"
      },
    • {
      • "amount": 1000,
      • "amount_refunded": 1000,
      • "amount_disputed": 1000,
      • "auto_capture": false,
      • "capture_at": null,
      • "create_time": 1510079535,
      • "currency": "USD",
      • "custom_data": null,
      • "failure_reason": null,
      • "fee_amount": 0,
      • "fee_amount_refundable": 0,
      • "id": "00000000-0000-0000-0000-00006fa82d45",
      • "order": {
        • "id": "be2b42e5-b808-40ae-9bbe-3291ab493f57",
        • "path": "/orders/be2b42e5-b808-40ae-9bbe-3291ab493f57",
        • "resource": "orders"
        },
      • "owner": {
        • "id": "be2b42e5-b808-40ae-9bbe-3291ab493f57",
        • "path": "/accounts/be2b42e5-b808-40ae-9bbe-3291ab493f57",
        • "resource": "accounts"
        },
      • "path": "/payments/00000000-0000-0000-0000-00006fa82d45",
      • "payment_method": {
        • "id": "00000000-6261-5553-0000-0000000001b8",
        • "path": "/payment_methods/00000000-6261-5553-0000-0000000001b8",
        • "resource": "payment_methods"
        },
      • "pending_reasons": [
        • {
          • "details": [ ],
          • "reason_code": "PROCESSING",
          • "reason_message": "Payment is being processed."
          }
        ],
      • "resource": "payments",
      • "status": "pending",
      • "authorization_code": "0224241",
      • "txnr_app_fee": null,
      • "txnr_merchant": null,
      • "initiated_by": "none",
      • "api_version": "3.2",
      • "reference_id": "d6a60610-3a7e-4b9d-b56f-9005b9cd18ac"
      }
    ]
}