v1

latestOpenAPI 3.1.02026-07-222392081.7 MB
Customers > Payment methods

Create payment method

Import an existing customer payment method from a connected payment provider.

post/v1/customers/{id}/payment-methods

Path parameters

idstring required

Request body

provider_name'airwallex' | 'gocardless' | 'mollie' | 'stripe' required

Provider name.

provider_idstring

Provider ID. Required if multiple instances of the same provider are connected in Hyperline.

provider_payment_method_idstring required

ID of the payment method on the provider's side.

Response

OR
OR
OR
OR
OR

Example response

{
  "id": "pm_1xMpj5bwRqN7LM",
  "status": "active",
  "type": "card",
  "last_4_digits": 2718,
  "expiration_date": "2027-11",
  "brand": "visa",
  "integration": {
    "entity_id": "123456789",
    "provider_name": "stripe",
    "provider_account_id": "acc_1234567890"
  }
}