Create customer payment method by external ID | Paid

import { PaidClient } from "@paid-ai/paid-node";
async function main() {
    const client = new PaidClient({
        token: "YOUR_TOKEN_HERE",
    });
    await client.customers.createPaymentMethod("externalId", {
        confirmationToken: "ctoken_1234567890",
        returnUrl: "https://example.com/payment-method-added",
        metadata: {
            "source": "api",
        },
    });
}
main();

{
  "id": "string",
  "type": "card",
  "card": {
    "brand": "string",
    "last4": "string",
    "expMonth": 1,
    "expYear": 1
  },
  "usBankAccount": {
    "bankName": "string",
    "last4": "string",
    "accountType": "checking"
  },
  "isDefault": true,
  "createdAt": "2024-01-15T09:30:00Z"
}

Creates a new payment method for a customer using a Stripe confirmation token.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

externalIdstringRequired

The external ID of the customer

Request

This endpoint expects an object.

confirmationTokenstringRequired

Stripe confirmation token for the payment method

returnUrlstringRequired

URL to redirect to after payment method setup

metadatamap from strings to anyOptional

Optional metadata to attach to the payment method

Response

Payment method created successfully

idstring

The payment method ID (typically from Stripe)

typeenum

The type of payment method

cardobject

Card details (present when type is ‘card’)

usBankAccountobject

US bank account details (present when type is ‘us_bank_account’)

isDefaultboolean

Whether this is the customer's default payment method

createdAtdatetime

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error