Backend API
Create a new customer account card.
Arguments
The unique identifier for the card.
The ID of the parent account.
Link to the associated payment token.
Indicates whether this card is active and available for use.
Indicates results of the address check for the card: unchecked, pass, or fail.
Possible enum values:
The customer's billing details. Defaults to account.billing. Updating billing will also update the corresponding account billing object.
Billing full name. If first_name or last_name are updated, then name will be automatically updated as a combination of first/last.
Customer's email address.
Customer's company, if applicable.
Billing first name. If name is updated, then first_name will be automatically updated as the first word of the name.
Billing last name. If name is updated, then last_name will be automatically updated as the last word of the name.
Billing phone number.
Name of card issuer. E.g., "visa".
Indicates results of the CVC check for the card: unchecked, pass, or fail.
Possible enum values:
The date the card entry was created.
Date the card entry was last updated.
The expiration month on the card, 1 through 12.
Four-digit card expiration year.
A hashed fingerprint generated using client_id, brand, and last4.
Name of the payment gateway.
The last four digits of the card number.
Link to the parent account.
Indicated the card is for testing purposes.
Indicates results of the zip check for the card: unchecked, pass, or fail.
Possible enum values:
const { swell } = require('swell-node');
swell.init('store-id', 'secret-key');
await swell.post('/accounts:cards', {
first_name: 'Jarl',
last_name: 'Balgruff',
address1: '543 Castle Way',
city: 'Whiterun',
state: 'CA',
country: 'US',
brand: 'Visa',
last4: '1234',
exp_month: 10,
exp_year: 2023,
});Response
{
"parent_id": "621e53a6213eaf013d1fa6b2",
"billing": {
"name": "Jarl Balgruff",
"first_name": "Jarl",
"last_name": "Balgruff",
"address1": "543 Castle Way",
"address2": null,
"city": "Whiterun",
"state": "CA",
"zip": null,
"country": "US",
"phone": null,
"company": null
},
"brand": "Visa",
"last4": "1234",
"exp_month": 10,
"exp_year": 2023,
"token": "card_QD5rOXP3I4bOmUCKlmLo7AzC",
"address_check": "unchecked",
"zip_check": "unchecked",
"cvc_check": "unchecked",
"fingerprint": "3628a7581fec797682e06740213c08f1",
"date_created": "2022-07-13T15:52:53.253Z",
"active": true,
"id": "64ceea552fa37600132711f4"
}