This API offers an alternative way to create a payment source using a single-use gateway temporary token, which is generally provided by your payment gateway. In the case of Stripe, this temporary token is generated according to the instruction detailed in Stripe documentation.
Storing card after successful 3DS completion is not supported in this API. Use create using Payment Intent API under Payment source to store the card after successful 3DS flow completion.
Sample Request
URL Format
Input Parameters
Identifier of the customer with whom this payment source is associated.
The gateway account to which the payment source is associated.
Type of payment source.
Card based payment including credit cards and debit cards. Details about the card can be obtained from the card resource.
Payments made via PayPal Express Checkout.
Payments made via Amazon Payments.
Represents bank account for which the direct debit or ACH agreement/mandate is created.
Payments made via Generic Payment Method.
Single-use token created by payment gateways. In Stripe, a single-use token is created for Apple Pay Wallet, card details or direct debit. In Braintree, a nonce is created for Apple Pay Wallet, PayPal, or card details. In Authorize.net, a nonce is created for card details. In Adyen, an encrypted data is created from the card details.
2-letter (alpha2) ISO country code. Indicates your customer's payment method country of issuance. Applicable for PayPal via Braintree.
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.
-
checkout_com: While adding a new payment method using permanent token or passing raw card details to Checkout.com,documentID andcountry_of_residenceare 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, iffraud_session_idis 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, yourfraud_merchant_idand the user'sdevice_session_idcan 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, iffraud_session_idis 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'sdevice_session_idcan 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 themerchant_idparameter is included, Chargebee will vault it / perform a lookup and verification against thismerchant_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'sdocumentis required for some countries anddevice_session_idcan 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 .
Returns
Resource object representing customer
Resource object representing payment_source