Card Information Saving

v1/card/save

It is the service that allows to save your card information without receiving payment via Paynet. You need to pay attention to the informations given below while using the card storage service.

• If you want to save your card during the transaction, you need a unique information of your customer. (userid , gsm no , e_mail etc. )

• When you make transaction of saving card informations for the first time , you must send this value to the parameter of user_unique_id .

• Then Paynet will generate a unique card_owner_id belongs to your customer.

• You need to also associate and store your own customer unique value and card_owner_id in your system.

• You will use “card_owner_id” for all of your later transactions. Once you have made a card save transaction to your customer, you will use card_owner_id parameter for saving card information or request to transactions from the saved card.

Note that you will need to do basic authentication with secret_key for using this service. expr.

https://api.paynet.com.tr/v1/card/save

Request Parameters

Parameter Name	Type	Required	Description
card_desc	string	Yes	The name will be given to stored card.
card_holder	string	Yes	The name on the card.
card_number	string	Yes	Card number.
expire_month	string	Yes	Month on the card.
expire_year	string	Yes	Year on the card.
cvv	string	No	CVV Code. If you send a CVV code, the bank will take pre-provision of 1 TL to check the accuracy of the card during card saving , then it will be canceled.
user_unique_id	string	No	Unique id that given to user by member workplace. It’s necessary if card saving will be perform at first time.
card_owner_id	string	No	Unique card holder information that has been generated by Paynet residing on user_unique_id after first card saving process. This value is also used in subsequent card saving services.
otp_code	string	No	Number that will be send to last user’s send_otp service as a parameter. Please contact our support team for more information.
otp_session_id	string	No	The value that will be associated with OTP. This value will be associated with the card information that will be saved. Please contact our support team for more information.
user_gsm	string	No	The phone number that will received otp_code from send_otp service when OTP Verification is required. Please contact our support team for more information.

Response Parameters

Parameter Name	Type	Description
card_desc	string	The name given to stored card.
card_hash	string	Hash value of card number.
card_no	string	Tokenized version of the first 6 and last 4 numbers of the card number.
card_bin	string	First six digits of the card.
card_type	string	Type of the card. Expr
card_bank_name	string	The bank name of the card.(Bonus,Axess,etc.)
card_logo_url	string	Logo image of the card.
card_brand_name	string	VISA,MASTERCARD,AMEX
card_owner_id	string	The unique value which is generated by Paynet for the owner of the card.
user_unique_id	string	The unique id of user which is given by member workplace. The value that sent in the first save process.
object_name	string	Name of Response API.
code	string	Code of Response Result. Expr
message	string	Description of Code.

Request

{  
   "user_gsm":"5xxxyyzz",
   "otp_session_id":"otp_session_id",
   "otp_code":"ART2",
   "card_desc":"Kart aciklamasi",
   "card_holder":"Onur Ozdemir",
   "card_number":"435508xxxxxxxx",
   "expire_month":"12",
   "expire_year":"18",
   "cvv":"000",
   "user_unique_id":"benzersiz deger"
}

Response

{  
   "card_owner_id":"abc45adc20-91ba-4a29-a599-0eb18177247e",
   "user_unique_id":"benzersiz deger",
   "card_desc":"test",
   "card_hash":"abcdef-8014-435e-8bcc-daf4592f3431",
   "card_no":"455508********8053",
   "card_bin":"435508",
   "card_type":"cc",
   "card_bank_name":"WorldCard",
   "card_logo_url":"https://pts-statics.paynet.com.tr/img/banklogo/small/AXSS.png",
   "card_brand_name":"VISA",
   "object_name":"card_save",
   "code":0,
   "message":"Başarılı İşlem"
}

Service URL

System	URL
Live System	https://api.paynet.com.tr/v1/card/save
Test System	https://pts-api.paynet.com.tr/v1/card/save