Store Card

URL

The endpoint and http method information to store card independently are stated below.

HTTP Method URL
POST /payment/v1/cards

Request Parameters

The parameters expected to be sent in the requests to be made for card storage are listed under the table and sub-headings below.

Parameter Name Type Required Description
cardHolderName string Yes Card Holder Name
We do not allow the following characters: \<>"%;&+()|=! and numbers
cardNumber string Yes Card Number
expireYear string Yes Expiry Year of the card
expireMonth string Yes Expiry Month of the card
cardAlias string No Name - Alias of the card
cardUserKey string No User key that generated before for the card

Response Parameters

Parameter Name Type Description
binNumber string First 8 digit of the card number
lastFourDigits string Last 4 digit of the card number
cardUserKey string User key value that generated after successful card storage. It should be stored by the merchant by associating it with the customer.
cardToken string Token value that generated after successful card storage. It should be stored by the merchant by associating it with the customer.
cardAlias string Name / Alias of the card
cardType CardType Kart türü. CREDIT_CARD, DEBIT_CARD ya da PREPAID_CARD See: Card Types
cardAssociation CardAssociation Card association VISA, MASTER_CARD, AMEX or TROY See: Card Associations
cardBrand string Brand of the card
cardBankName string Name of the card bank
cardBankId number ID value of the card bank
cardExpiryStatus CardExpiryStatus Card expiry status. EXPIRED, WILL_EXPIRE_NEXT_MONTH,or NOT_EXPIRED

Sample Codes

You can review the sample codes in the open source Craftgate API clients.