Stored Instruments API (Beta) - Payments Server Operations
The Stored Instruments API gives shoppers the ability to save credit cards, bank accounts, and PayPal accounts for a faster checkout experience.
Attach Instrument to Customer
POST https://payments.bigcommerce.com/stores/{store_hash}/stored-instrumentsRequest
Adds an instrument to customer.
Authentication
- IAT {{INSTRUMENT_ACCESS_TOKEN}} in headerrequired
Parameters
- store_hash in path - string
Body
object | application/json
payment_method_idstring
requiredIdentifier for payment method that will be used for this instrument obtained from Payment Methods API.
Example: braintree.paypalcurrency_codestring
requiredThe instrument currency.
Example: USDcustomer_idstring
requiredThe ID of the customer to add instrument for.
Example: 1default_instrumentboolean
Set this instrument as default for customer?
instrument
requiredAny of:object object numberstring
requiredThe raw card number.
Example: 4111111111111111expiration_yearinteger
requiredThe expiration year.
Example: 2024expiration_monthinteger
requiredThe expiration day.
Example: 12verification_valuestring
requiredThe security code.
Example: 123cardholder_namestring
requiredThe cardholder name.
Example: test nametypestring
requiredThe type of instrument. For this case "raw_card".
Allowed: raw_card | tokenized_card | tokenized_paypal_account
Example: raw_card
trusted_shipping_addressesarray[object] Trusted shipping address for instrument.
billing_addressobject Example: {"first_name":"Tester","last_name":"Tester","email":"example@email.com","company":"","street_1":"1 Sample Street","street_2":"","city":"Tampa","state_code":"NV","country_code":"US","phone":"101-192-0293","zip":"55555"}
example
Response
Created instrument
Body
object | application/json
data
paypal_instrument
credit_card_instrument
Did you find what you were looking for?