Cards

You can store multiple cards on a customer in order to charge the customer later. You can also store multiple debit cards on a recipient in order to transfer to those cards later.

Related guide: Card payments with Sources

Endpoints

Create a card

• POST /v1/customers/:id/sources

Update a card

• POST /v1/customers/:id/sources/:id

Retrieve a card

• GET /v1/customers/:id/cards/:id

List all cards

• GET /v1/customers/:id/cards

Delete a card

• DELETE /v1/customers/:id/sources/:id

Events

• account.external_account.created Occurs whenever an external account is created.

• account.external_account.deleted Occurs whenever an external account is deleted.

• account.external_account.updated Occurs whenever an external account is updated.

• customer.source.created Occurs whenever a new source is created for a customer.

• customer.source.deleted Occurs whenever a source is removed from a customer.

• customer.source.expiring Occurs whenever a card or source will expire at the end of the month. This event only works with legacy integrations using Card or Source objects. If you use the PaymentMethod API, this event won’t occur.

• customer.source.updated Occurs whenever a source’s details are changed.