comecerodocs

Retrieve a payment list

GET
/payment_list/{payment_list_id}

Returns a group of payments acted on together, such as the captures or voids made when you capture or void an order. Secret and trusted tokens only; a limited token gets 403. An unknown id returns an empty list, not 404.

Authorization

headerAuthorizationBearer <token>

A secret, trusted or limited token. See Authentication.

Path Parameters

payment_list_id*string

The id of the payment list.

Query Parameters

expand?string

Comma-separated child objects to return in full instead of as a URL, for example customer,payments. Use dot notation for nested objects (items.product), up to four levels deep. A single object takes up to 12 paths; a list takes up to 2, applied to every item. Extra paths are dropped without an error. See Expanding objects.

show?string

Comma-separated fields to return; all others are left out. Use dot notation for child fields (customer.email). You cannot send show and hide together (400). See Customizing output.

hide?string

Comma-separated fields to leave out of the response. Use dot notation for child fields (customer.email). You cannot send show and hide together (400). See Customizing output.

Response Body

The payment list.

application/json
  1. response

A group of payments acted on together, such as the captures or voids made when you capture or void an order with more than one payment. Not a page of a list: it has no paging.

object*"payment_list"

The object type. Always payment_list.

Value in"payment_list"
url*string

The full URL of the payment list.

Formaturi
payment_list_id*string

The id of the payment list.

test*boolean

True for test payments. False when the list is empty.

account_id*|

The account of the payments. Null when the list is empty.

currency*|

The currency of the first payment. Null when the list is empty.

subtotal*number

The sum of subtotal of the pending and completed payments.

shipping*number

The sum of shipping of the pending and completed payments.

tax*number

The sum of tax of the pending and completed payments.

total*number

The sum of total of the pending and completed payments.

success_count*integer

How many payments have success true.

failure_count*integer

How many payments have success false.

payments*array<>

The payments.

Example Request
curl -X GET 'https://api.comecero.com/api/v1/payment_list/string'
Example Response
{  "object": "payment_list",  "url": "https://api.comecero.com/api/v1/payment_list/0091310055812aB3kQ9",  "payment_list_id": "0091310055812aB3kQ9",  "test": true,  "account_id": "AB1234",  "currency": "USD",  "subtotal": 199.9,  "shipping": 0,  "tax": 14.99,  "total": 214.89,  "success_count": 1,  "failure_count": 0,  "payments": []}