POST /payment_sources/create_using_permanent_token

The device from which the customer has made the request

Default value: "application/x-www-form-urlencoded"

skip only webhooks

Valid values:

• "all-disabled"

If the site has multiple business entities, you can use this custom HTTP header to specify the business entity for which Chargebee should perform the operation.

skip all actions to be done on the events

Valid values:

• "all-disabled"

The email address of your customer/user. Use this when the email address has only ASCII characters.

The IP address of the customer where the request originated

The Base64-encoded email address of your customer/user. Use this if the email address has UTF-8 characters. When this header is provided, the header chargebee-request-origin-user is ignored.

skip only emails

Valid values:

• "all-disabled"

An identifier provided by the gateway or card vault for the specific payment method resource.

A unique identifier associated with a customer`s profile within a payment gateway.

Parameters of tokenized card details

The Issuer Identification Number, i.e. the first six digits of the card number

Card Funding type * not_known - An unknown card. * prepaid - A prepaid card. * debit - A debit card. * credit - A credit card. * not_applicable - Used for ACH. Not applicable for cards

Valid values:

• "credit"
• "not_known"
• "prepaid"
• "debit"

Card brand * jcb - A JCB card. * cabal - A Cabal card. * hipercard - An Hipercard. * other - Card belonging to types other than those listed above. * cartes_bancaires - A Cartes Bancaires card. * american_express - An American Express card. * visa - A Visa card. * cencosud - A Cencosud card. * bancontact - A Bancontact card. * cmr_falabella - A CMR Falabella card. * not_applicable - Used for offline entries in transactions. Not applicable for cards * rupay - A Rupay card. * maestro - A Maestro card. * carnet - A Carnet card. * nativa - A Nativa card. * discover - A Discover card. * argencard - An Argencard. * dankort - A Dankort card. * tarjeta_naranja - A Tarjeta Naranja card. * elo - A Elo card. * diners_club - A Diner's Club card. * mastercard - A MasterCard.

Valid values:

• "bancontact"
• "nativa"
• "maestro"
• "tarjeta_naranja"
• "argencard"
• "other"
• "carnet"
• "cencosud"
• "visa"
• "jcb"
• "cartes_bancaires"
• "discover"
• "diners_club"
• "hipercard"
• "elo"
• "dankort"
• "cmr_falabella"
• "cabal"
• "mastercard"
• "rupay"
• "american_express"

Card expiry year.

Last four digits of the card number

Card expiry month.

• checkout_com: While adding a new payment method using permanent token or passing raw card details to Checkout.com, document ID and country_of_residence are required to support payments through dLocal.
  • payer: User related information.
    • country_of_residence: This is required since the billing country associated with the user’s payment method may not be the same as their country of residence. Hence the user’s country of residence needs to be specified. The country code should be a two-character ISO code.
    • document: Document ID is the user’s identification number based on their country.
• bluesnap: While passing raw card details to BlueSnap, if fraud_session_id is added, additional validation is performed to avoid fraudulent transactions.
  • fraud: Fraud identification related information.
    • fraud_session_id: Your BlueSnap fraud session ID required to perform anti-fraud validation.
• braintree: While passing raw card details to Braintree, your fraud_merchant_id and the user’s device_session_id can be added to perform additional validation and avoid fraudulent transactions.
  • fraud: Fraud identification related information.
    • device_session_id: Session ID associated with the user's device.
    • fraud_merchant_id: Your merchant ID for fraud detection.
• chargebee_payments: While passing raw card details to Chargebee Payments, if fraud_session_id is added, additional validation is performed to avoid fraudulent transactions.
  • fraud: Fraud identification related information.
    • fraud_session_id: Your Chargebee Payments fraud session ID required to perform anti-fraud validation.
• bank_of_america: While passing raw card details to Bank of America, your user’s device_session_id can be added to perform additional validation and avoid fraudulent transactions.
  • fraud: Fraud identification related information.
    • device_session_id: Session ID associated with the user's device.
• ecentric: This parameter is used to verify and process payment method details in Ecentric. If the merchant_id parameter is included, Chargebee will vault it / perform a lookup and verification against this merchant_id, overriding the one configured in Chargebee. If tokens and processing occur in the same Merchant GUID, you can just skip this part.
  • merchant_id: Merchant GUID where the card is vaulted or need to be vaulted.
• ebanx: While passing raw card details to EBANX, the user's document is required for some countries and device_session_id can be added to perform additional validation and avoid fraudulent transactions.
  • payer: User related information.
    • document: Document is the user's identification number based on their country.
  • fraud: Fraud identification related information.
    • device_session_id: Session ID associated with the user's device

Indicates whether the primary payment source should be replaced with this payment source. In case of Create Subscription for Customer endpoint, the default value is True. Otherwise, the default value is False.

Default value: false

The reference id. In the case of Amazon and PayPal, this will be the billing agreement ID. For GoCardless direct debit this will be mandate_id. In the case of a card, this will be the identifier provided by the gateway or card vault for the specific payment method resource.

Identifier of the customer with whom this payment source is associated.

The gateway account to which the payment source is associated.

The type of payment method. For more details refer Update payment method for a customer API under Customer resource. * direct_debit - Represents bank account for which the direct debit or ACH agreement/mandate is created. * unionpay - Payments made via UnionPay. * faster_payments - Payments made via Faster Payments * google_pay - Payments made via Google Pay. * sepa_instant_transfer - Payments made via Sepa Instant Transfer * dotpay - Payments made via Dotpay. * pay_to - Payments made via PayTo * generic - Payments made via Generic Payment Method. * giropay - Payments made via giropay. * klarna_pay_now - Payments made via Klarna Pay Now * automated_bank_transfer - Represents virtual bank account using which the payment will be done. * paypal_express_checkout - Payments made via PayPal Express Checkout. * alipay - Payments made via Alipay.
This payment source is deprecated. * venmo - Payments made via Venmo * sofort - Payments made via Sofort. * wechat_pay - Payments made via WeChat Pay.
This payment source is deprecated. * ideal - Payments made via iDEAL. * netbanking_emandates - Netbanking (eMandates) Payments. * upi - UPI Payments. * bancontact - Payments made via Bancontact Card. * card - Card based payment including credit cards and debit cards. Details about the card can be obtained from the card resource. * payconiq_by_bancontact - Payments made via Payconiq by Bancontact * amazon_payments - Payments made via Amazon Payments. * apple_pay - Payments made via Apple Pay.

Valid values:

• "upi"
• "online_banking_poland"
• "unionpay"
• "direct_debit"
• "netbanking_emandates"
• "giropay"
• "venmo"
• "payconiq_by_bancontact"
• "card"
• "klarna_pay_now"
• "faster_payments"
• "sepa_instant_transfer"
• "alipay"
• "bancontact"
• "amazon_payments"
• "sofort"
• "automated_bank_transfer"
• "paypal_express_checkout"
• "apple_pay"
• "pay_to"
• "generic"
• "dotpay"
• "google_pay"
• "wechat_pay"
• "ideal"

2-letter (alpha2) ISO country code. Indicates your customer's payment method country of issuance. Applicable for PayPal via Braintree.

An identifier of mandates which is an authorization given by the payer (usually a customer or account holder) to allow a third party such as a merchant or service provider to initiate payments from their account.

By default, the value is false and payment method details will be retrieved from the selected payment gateway using reference_id or payment_method_token / customer_profile_token / network_transaction_id / mandate_id. Learn more about the multiple token combinations of each gateway from this document.

Enter the value as true for the payment gateways that do not allow to retrieve the payment method details. Once passed, it will create payment method at Chargebee with the provided attributes in payment_method_token, customer_profile_token, network_transaction_id, mandate_id, card, and billing_address.

Default value: false

An identifier of the payment or authorization transaction at the gateway initiated using this payment method.

Parameters for billing_address

Address line 2

Address line 1

The email address.

The last name of the billing contact.

Address line 3

The ISO 3166-2 state/province code without the country prefix. Currently supported for USA, Canada and India. For instance, for Arizona (USA), set state_code as AZ (not US-AZ). For Tamil Nadu (India), set as TN (not IN-TN). For British Columbia (Canada), set as BC (not CA-BC).

Zip or postal code. The number of characters is validated according to the rules specified here.

The first name of the billing contact.

The state/province name. Is set by Chargebee automatically for US, Canada and India If state_code is provided.

The billing address country of the customer. Must be one of ISO 3166 alpha-2 country code.

The name of the city.