Skip to content
Developer Guide
/
/
Retrieve a payment method

Chaching API (1.0)

Chaching is a modern subscription-billing platform designed to simplify product management, customer lifecycle workflows, and recurring payments. It combines a clean dashboard for business users with a powerful API built for developers who need full automation and control.

Download OpenAPI description
api.json
api.yaml
Overview
Languages
Servers
Mock server
https://chaching.redocly.app/_mock/developer-guide/api

Customers

This object represents a customer of your business. Use it to create recurring charges, save payment and contact information, and track payments that belong to the same customer.

Operations

Products

Products describe the specific goods or services you offer to your customers. For example, you might offer a Standard and Premium version of your goods or service; each version would be a separate Product.

Operations

Transactions

Transactions represent the payments and charges made by your customers.

Operations

Invoices

Invoices are statements of amounts owed by a customer, and are either generated one-off, or generated periodically from a subscription.

Operations

TaxRates

TaxRates allow you to calculate the tax to collect from your customer.

Operations

Prices

This object represents a price in your Chaching account. Use it to define the cost of your products, configure one-time or recurring billing intervals, specify tax behavior, and manage pricing updates or deactivations for your offerings.

Operations

Subscriptions

Subscriptions are a way to charge your customers on a recurring basis. They can be used for products or services that are delivered over time, such as memberships or software licenses.

Operations

Balance

Balances represent the amount of money in your account. You can use balances to track your income and expenses, and to make payments to your customers or vendors.

Operations

Payment Methods

Payment Methods represent a way to collect payment from your customers. They can be attached to customers to make charging easier and more efficient.

Operations

List all payment methods

Request

Retrieves a list of payment methods for the current account, based on the authentication that was used to make the request.

Query
searchstring
Default ""
pagenumber>= 1
Default 1
takenumber[ 1 .. 50 ]
Default 10
Headers
cc-api-keystringrequired

Chaching API Key

curl -i -X GET \
  'https://chaching.redocly.app/_mock/developer-guide/api/payment-methods?page=1&take=10' \
  -H 'cc-api-key: string'

Responses

List of payment methods

Bodyapplication/json
dataArray of arraysrequired
metaobject(PageMetaDto)required
meta.​pagenumberrequired
meta.​takenumberrequired
meta.​itemsTotalnumberrequired
meta.​pagesTotalnumberrequired
Response
application/json
{
  "data": [
    []
  ],
  "meta": {
    "page": 0,
    "take": 0,
    "itemsTotal": 0,
    "pagesTotal": 0
  }
}

Retrieve a payment method

Request

Retrieves detailed information about a specific payment method for the current account, based on the authentication that was used to make the request.

Path
idstringrequired
Headers
cc-api-keystringrequired

Chaching API Key

curl -i -X GET \
  'https://chaching.redocly.app/_mock/developer-guide/api/payment-methods/{id}' \
  -H 'cc-api-key: string'

Responses

Payment method details

Bodyapplication/json
idstringrequired

Unique identifier for the payment method.

Example: "pm_1Q0PsIJvEtkwdCNYMSaVuRz6"
objectstringrequired

Type of Stripe object.

Example: "payment_method"
allow_redisplaystringrequired

Controls whether the payment method can be redisplayed.

Example: "unspecified"
billing_detailsobjectrequired

Billing details associated with the payment method.

billing_details.​addressobjectrequired

Billing address associated with the payment method.

billing_details.​address.​citystring or null

City of the billing address.

Example: null
billing_details.​address.​countrystring or null

Country of the billing address.

Example: null
billing_details.​address.​line1string or null

Street line 1 of the billing address.

Example: null
billing_details.​address.​line2string or null

Street line 2 of the billing address.

Example: null
billing_details.​address.​postal_codestring or null

Postal or ZIP code.

Example: null
billing_details.​address.​statestring or null

State or province.

Example: null
billing_details.​emailstring or null

Billing email address.

Example: null
billing_details.​namestring or nullrequired

Full name of the account owner.

Example: "John Doe"
billing_details.​phonestring or null

Owner phone number.

Example: null
creatednumberrequired

Unix timestamp when the payment method was created.

Example: 1726673582
customerstring or null

ID of the attached customer, if any.

Example: null
livemodebooleanrequired

Indicates if the object exists in live mode.

Example: false
metadataobjectrequired

Set of key-value pairs for storing additional information.

Example: {}
typestringrequired

Payment method type.

Example: "us_bank_account"
us_bank_accountobject

US bank account details if the payment method is a bank account.

Response
application/json
{
  "id": "pm_1Q0PsIJvEtkwdCNYMSaVuRz6",
  "object": "payment_method",
  "allow_redisplay": "unspecified",
  "billing_details": {
    "address": { … },
    "email": null,
    "name": "John Doe",
    "phone": null
  },
  "created": 1726673582,
  "customer": null,
  "livemode": false,
  "metadata": {},
  "type": "us_bank_account",
  "us_bank_account": {
    "account_holder_type": "individual",
    "account_type": "checking",
    "bank_name": "STRIPE TEST BANK",
    "financial_connections_account": null,
    "fingerprint": "LstWJFsCK7P349Bg",
    "last4": "6789",
    "networks": { … },
    "routing_number": "110000000",
    "status_details": {}
  }
}

Attach a payment method

Request

Attaches a payment method to a customer for the current account, based on the authentication that was used to make the request.

Path
idstringrequired
Headers
cc-api-keystringrequired

Chaching API Key

Bodyapplication/jsonrequired
customerIdstringrequired

ID of the customer to attach the payment method to

Example: "cust_123456789"
curl -i -X POST \
  'https://chaching.redocly.app/_mock/developer-guide/api/payment-methods/{id}/attach' \
  -H 'Content-Type: application/json' \
  -H 'cc-api-key: string' \
  -d '{
    "customerId": "cust_123456789"
  }'

Responses

Payment method details

Bodyapplication/json
idstringrequired

Unique identifier for the payment method.

Example: "pm_1Q0PsIJvEtkwdCNYMSaVuRz6"
objectstringrequired

Type of Stripe object.

Example: "payment_method"
allow_redisplaystringrequired

Controls whether the payment method can be redisplayed.

Example: "unspecified"
billing_detailsobjectrequired

Billing details associated with the payment method.

billing_details.​addressobjectrequired

Billing address associated with the payment method.

billing_details.​address.​citystring or null

City of the billing address.

Example: null
billing_details.​address.​countrystring or null

Country of the billing address.

Example: null
billing_details.​address.​line1string or null

Street line 1 of the billing address.

Example: null
billing_details.​address.​line2string or null

Street line 2 of the billing address.

Example: null
billing_details.​address.​postal_codestring or null

Postal or ZIP code.

Example: null
billing_details.​address.​statestring or null

State or province.

Example: null
billing_details.​emailstring or null

Billing email address.

Example: null
billing_details.​namestring or nullrequired

Full name of the account owner.

Example: "John Doe"
billing_details.​phonestring or null

Owner phone number.

Example: null
creatednumberrequired

Unix timestamp when the payment method was created.

Example: 1726673582
customerstring or null

ID of the attached customer, if any.

Example: null
livemodebooleanrequired

Indicates if the object exists in live mode.

Example: false
metadataobjectrequired

Set of key-value pairs for storing additional information.

Example: {}
typestringrequired

Payment method type.

Example: "us_bank_account"
us_bank_accountobject

US bank account details if the payment method is a bank account.

Response
application/json
{
  "id": "pm_1Q0PsIJvEtkwdCNYMSaVuRz6",
  "object": "payment_method",
  "allow_redisplay": "unspecified",
  "billing_details": {
    "address": { … },
    "email": null,
    "name": "John Doe",
    "phone": null
  },
  "created": 1726673582,
  "customer": null,
  "livemode": false,
  "metadata": {},
  "type": "us_bank_account",
  "us_bank_account": {
    "account_holder_type": "individual",
    "account_type": "checking",
    "bank_name": "STRIPE TEST BANK",
    "financial_connections_account": null,
    "fingerprint": "LstWJFsCK7P349Bg",
    "last4": "6789",
    "networks": { … },
    "routing_number": "110000000",
    "status_details": {}
  }
}

Detach a payment method

Request

Detaches a payment method from a customer for the current account, based on the authentication that was used to make the request.

Path
idstringrequired
Headers
cc-api-keystringrequired

Chaching API Key

curl -i -X POST \
  'https://chaching.redocly.app/_mock/developer-guide/api/payment-methods/{id}/detach' \
  -H 'cc-api-key: string'

Responses

Payment method details

Bodyapplication/json
idstringrequired

Unique identifier for the payment method.

Example: "pm_1Q0PsIJvEtkwdCNYMSaVuRz6"
objectstringrequired

Type of Stripe object.

Example: "payment_method"
allow_redisplaystringrequired

Controls whether the payment method can be redisplayed.

Example: "unspecified"
billing_detailsobjectrequired

Billing details associated with the payment method.

billing_details.​addressobjectrequired

Billing address associated with the payment method.

billing_details.​address.​citystring or null

City of the billing address.

Example: null
billing_details.​address.​countrystring or null

Country of the billing address.

Example: null
billing_details.​address.​line1string or null

Street line 1 of the billing address.

Example: null
billing_details.​address.​line2string or null

Street line 2 of the billing address.

Example: null
billing_details.​address.​postal_codestring or null

Postal or ZIP code.

Example: null
billing_details.​address.​statestring or null

State or province.

Example: null
billing_details.​emailstring or null

Billing email address.

Example: null
billing_details.​namestring or nullrequired

Full name of the account owner.

Example: "John Doe"
billing_details.​phonestring or null

Owner phone number.

Example: null
creatednumberrequired

Unix timestamp when the payment method was created.

Example: 1726673582
customerstring or null

ID of the attached customer, if any.

Example: null
livemodebooleanrequired

Indicates if the object exists in live mode.

Example: false
metadataobjectrequired

Set of key-value pairs for storing additional information.

Example: {}
typestringrequired

Payment method type.

Example: "us_bank_account"
us_bank_accountobject

US bank account details if the payment method is a bank account.

Response
application/json
{
  "id": "pm_1Q0PsIJvEtkwdCNYMSaVuRz6",
  "object": "payment_method",
  "allow_redisplay": "unspecified",
  "billing_details": {
    "address": { … },
    "email": null,
    "name": "John Doe",
    "phone": null
  },
  "created": 1726673582,
  "customer": null,
  "livemode": false,
  "metadata": {},
  "type": "us_bank_account",
  "us_bank_account": {
    "account_holder_type": "individual",
    "account_type": "checking",
    "bank_name": "STRIPE TEST BANK",
    "financial_connections_account": null,
    "fingerprint": "LstWJFsCK7P349Bg",
    "last4": "6789",
    "networks": { … },
    "routing_number": "110000000",
    "status_details": {}
  }
}