Paynet API
Search…
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.
Request Parameters
Response Parameters
Request
Response
Service URL
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.
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.
1
{
2
"user_gsm":"5xxxyyzz",
3
"otp_session_id":"otp_session_id",
4
"otp_code":"ART2",
5
"card_desc":"Kart aciklamasi",
6
"card_holder":"Onur Ozdemir",
7
"card_number":"435508xxxxxxxx",
8
"expire_month":"12",
9
"expire_year":"18",
10
"cvv":"000",
11
"user_unique_id":"benzersiz deger"
12
}
Copied!
1
{
2
"card_owner_id":"abc45adc20-91ba-4a29-a599-0eb18177247e",
3
"user_unique_id":"benzersiz deger",
4
"card_desc":"test",
5
"card_hash":"abcdef-8014-435e-8bcc-daf4592f3431",
6
"card_no":"455508********8053",
7
"card_bin":"435508",
8
"card_type":"cc",
9
"card_bank_name":"WorldCard",
10
"card_logo_url":"https://pts-statics.paynet.com.tr/img/banklogo/small/AXSS.png",
11
"card_brand_name":"VISA",
12
"object_name":"card_save",
13
"code":0,
14
"message":"Başarılı İşlem"
15
}
Copied!
System
URL
Live System
https://api.paynet.com.tr/v1/card/save
Test System
https://pts-api.paynet.com.tr/v1/card/save
Last modified 4mo ago
Copy link