Create a Payment Methods

​

Creates a PaymentMethod.

Body
required
application/json
  • Type: object

    PaymentMethod objects represent your customer's payment instruments. You can use them with PaymentIntents to collect payments or save them to Customer objects to store instrument details for future payments.

    • type
      enum
      const:  
      card
      required

      The type of the PaymentMethod. An additional hash is included on the PaymentMethod with a name matching this value. It contains additional information specific to the PaymentMethod type.

      values
      • card
    • billing_details
      Type: object · BillingDetails

      Billing information associated with the PaymentMethod that may be used or required by particular types of payment methods.

    • card
      Type: object · PaymentMethodCard

      PaymentMethodCard

    • confirmation_token

      Provide one of token OR token_intent_id

      • token_id
        Type: string
        required

        Confirmation token.

      • token_intent_id
        Type: string

        Ephemeral token intent.

    • customer
      Type: string
      max length:  
      100

      ID of an existing Customer, if one exists.

    • metadata

      Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata.

      • propertyName
        Type: string
Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/v1/payment_methods
curl https://api.paypercut.io/v1/payment_methods \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "type": "card",
  "card": {
    "cardholder_name": null,
    "brand": "",
    "country": null,
    "issuer": null,
    "display_brand": null,
    "exp_month": 1,
    "exp_year": 1,
    "fingerprint": null,
    "funding": "",
    "segment": "",
    "iin": "",
    "last4": "",
    "wallet": {
      "dynamic_last4": null,
      "type": "apple_pay"
    },
    "three_d_secure_usage": {
      "supported": true
    }
  },
  "billing_details": {
    "email": null,
    "name": null,
    "phone": null,
    "address": {
      "city": null,
      "country": null,
      "line1": null,
      "line2": null,
      "postal_code": null,
      "state": null
    }
  },
  "metadata": {
    "additionalProperty": ""
  },
  "customer": "",
  "confirmation_token": {
    "token_id": "",
    "token_intent_id": ""
  }
}'

{
  "type": "card",
  "card": {
    "cardholder_name": null,
    "brand": "string",
    "country": null,
    "issuer": null,
    "display_brand": null,
    "exp_month": 1,
    "exp_year": 1,
    "fingerprint": null,
    "funding": "string",
    "segment": "string",
    "iin": "string",
    "last4": "string",
    "wallet": {
      "dynamic_last4": null,
      "type": "apple_pay"
    },
    "three_d_secure_usage": {
      "supported": true
    }
  },
  "billing_details": {
    "email": null,
    "name": null,
    "phone": null,
    "address": {
      "city": null,
      "country": null,
      "line1": null,
      "line2": null,
      "postal_code": null,
      "state": null
    }
  },
  "metadata": {
    "additionalProperty": "string"
  },
  "customer": "string",
  "id": "string",
  "livemode": true,
  "created": "2026-04-03T12:46:07.666Z"
}

Payment Method Details