Create a Token - Card

post

https://testapi.payarc.net/v1/tokens

This API creates a token that represents a credit or debit card used to carry out a transaction.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

card_source

string

enum

required

Defaults to INTERNET

This field indicates how the card data was captured at the point of sale.

FormatAllowed ValuesExamplesNotesAlphabeticMANUAL PHONE MAIL INTERNET9 would be $0.09;
99999999 would be $999,999.99PAYARC processes the transaction as 'card not present' if the field value is PHONE, MAIL, or INTERNET. For any other type of transaction, PAYARC processes the transaction as 'card present'.

Allowed:

card_number

int32

required

The 14-19 digit card number used for the transaction.

FormatMin LengthMax LengthAllowed ValuesExamplesNumeric14 digits19 digitsusdVISA: 4012000098765439
MASTERCARD: 5146315000000055
AMEX: 371449635392376
DISCOVER: 6011000993026909
DISCOVER CUP: 6282000123842342
DINERS: 3055155515160018
JCB: 3530142019945859

exp_month

string

required

The month value displayed on the card used for the transaction.

FormatMin LengthMax LengthExamplesNumeric11201 represents the month of January.

exp_year

string

required

The YYYY value mentioned on the card used for the transaction.

FormatMin LengthMax LengthExamplesNumeric2 digits4 digits2025

cvv

string

required

The three or four-digit security code on the card.

FormatMin LengthMax LengthNotesNumeric3 digits4 digitsThis field can be set as 'Required' or 'Optional' at the account level by a PAYARC Admin. Email [email protected] to contact the Admin. If this field is set as 'Required' and is not sent or is incorrect, the transaction may be declined based on the risk parameters set. If this field is set as 'Optional' and is not sent or is incorrect, the transaction will be processed as CVV availability not provided.

card_holder_name

string

Name of the cardholder as mentioned on the card used to carry out the transaction.

FormatMin LengthMax LengthExamplesAlphabetic and Whitespace1 character30 caractersJohn Smith

address_line1

string

The cardholder's billing address for line 1.

FormatMin LengthMax LengthExamplesNotesAlphanumeric1 character200 characters103 Mason StreetThis field will be 'Required' if address information is requested by the merchant. Payfac Max Length: 30 characters

address_line2

string

The cardholder's billing address for line 2.

FormatMin LengthMax LengthExamplesNotesAlphanumeric1 character200 characters2nd FloorNote: Payfac Max Length: 30 characters

city

string

The cardholder's state name. Can be State/County/Province/Region.

FormatMin LengthMax LengthExamplesNotesAlphabetic and Whitespace1 character50 charactersNey YorkThis field will be 'Required' if address information is requested by the merchant.

state

string

The cardholder's state name. Can be State/County/Province/Region.

FormatMin LengthMax LengthExamplesNotesAlphabetic and Whitespace1 character50 charactersNYThis field will be 'Required' if address information is requested by the merchant.

zip

int32

The cardholder's billing ZIP code.

FormatMin LengthMax LengthExamplesNotesNumeric2 digits10 digits10469This field will be 'Required' if address information is requested by the merchant.

country

string

The cardholder's country name.

FormatMin LengthMax LengthExamplesNotesAlphabetic1 character50 charactersUSThis field will be 'Required' if address information is requested by the merchant.

authorize_card

int32

This field helps check card validity.

FormatDefaultNotesBoolean00 will not authorize the card while creating a Token. 1 will authorize the customer's card for $0.00, which may result in additional fees. Failure to authorize the card may result in failed subscriptions.

Headers

content-type

string

enum

Defaults to application/json

Generated from available request content types

Allowed:

Responses

201201

409409