comecerodocs
Payments

Retrieve a payment's payment method

GET
/payments/{payment_id}/payment_method

Returns the payment method used for the payment, with card details masked. Any token type may call it; a limited token only for a payment it is bound to.

Authorization

headerAuthorizationBearer <token>

A secret, trusted or limited token. See Authentication.

Path Parameters

payment_id*string

The id of the payment.

Query Parameters

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 method.

application/json
  1. response

A payment method saved to a customer, used again for later payments and subscription renewals. What data holds depends on type. Card and bank numbers are kept encrypted in Comecero's vault and are never returned; only masks, the last four digits and the brand come back. A card's security code is never stored.

object*"payment_method"

The object type. Always payment_method.

Value in"payment_method"
url*|

The full URL of the payment method.

payment_method_id*string

The id of the payment method.

date_created*string

When the payment method was saved.

Formatdate-time
date_modified*string

When the payment method was last changed.

Formatdate-time
test*boolean

True for a test payment method. Always matches the customer.

type*string

The kind of payment method. stripe is Comecero Express Payments. wallet is Google Pay or Apple Pay.

Value in"credit_card""ach""paypal""amazon_pay""apple_pay""stripe""wallet"
data?|||||

The details for this type. Not present for apple_pay.

is_default*boolean

True for the customer's default payment method, the one used when a payment, renewal or new subscription names the customer but no payment method. The first method saved becomes the default.

date_last_used*|

When the payment method was last used for a successful payment.

Formatdate-time
formatted?

Only when you send formatted=true. Display text.

Example Request
curl -X GET 'https://api.comecero.com/api/v1/payments/string/payment_method'
Example Response
{  "url": "https://api.comecero.com/api/v1/customers/0091304300408CuoxY9Pf3/payment_methods/0092503470929PmEP0ivO4",  "object": "payment_method",  "payment_method_id": "0092503470929PmEP0ivO4",  "date_created": "2026-11-02T18:20:31Z",  "date_modified": "2026-11-02T18:20:31Z",  "test": true,  "type": "credit_card",  "data": {    "object": "credit_card",    "mask": "4***********1111",    "fingerprint": "2321657x8123834dc21ea08f",    "exp_month": 12,    "exp_year": 28,    "cardholder_name": "John Doe",    "ending": "1111",    "type": "Visa",    "label": "Visa 1111",    "billing_address": {      "object": "address",      "name": "John Doe",      "address_1": "123 Main St.",      "address_2": null,      "city": "New York",      "state_prov": "NY",      "postal_code": "10019",      "country": "US",      "email": null,      "meta": null    }  },  "is_default": true,  "date_last_used": "2026-11-02T18:20:31Z"}

List payment notifications GET

Lists the emails and other notifications sent for a payment, such as the receipt. An offset-based list. `sort_by` takes `date_created` (the default) or `date_modified`. Any token type may call it; a limited token only for a payment it is bound to.

List payment refunds GET

Lists the refunds and chargebacks of a payment. An offset-based list. `sort_by` takes `date_created` (the default), `date_modified` or `date_completed`. Any token type may call it; a limited token only for a payment it is bound to.