Paynet API
Search…
Payment
Customers are able to do non-installment, in installments and saving card payment transactions without using 3D verification. Direct payment amount is charged from credit card without 3D verification.
You should perform basic authentication with secret_key to use payment service. See more
You must be authorized to use this service since 3D verification doesn’t perform on this service. You can contact your sales representative about this issue.
Request Parameters
Response Parameters
Request
Response
Service Url
Parameter
Type
Required
Description
amount
decimal
Yes
Amount that charges from credit card. (You should use a comma (,) as a decimal seperator.)
reference_no
string
Yes
Reference no that related with the payment transaction. It must be unique.
domain
string
Yes
This is website that integrated payment api.
agent_reference_no
string
No
Reference code of company's agent.
card_holder
string
No
Informations of card owner. It’s necessary if transaction doesn’t perform by saved card.
pan
string
No
Card number. It’s necessary if transaction doesn’t perform by saved card.
month
int
No
Month of card expiration date (e.g 8, 12). It’s necessary if transaction doesn’t perform by saved card.
year
int
No
Year of card expiration date (e.g 2020, 2030). It’s necessary if transaction doesn’t perform by saved card.
cvc
string
No
Card security code. It’s necessary if transaction doesn’t perform by saved card.
card_hash
string
No
Token information of saved card. It's necessary if transaction performs by saved card.
card_holder_phone
string
No
Phone number of card holder.
card_holder_mail
string
No
Mail address of card holder.
description
string
No
Decription area that related with transaction.
instalment
int
No
Information about how many installments will be perform on.
agent_id
string
No
If you have a sub agent you can track transaction that comes from which agent as post agent id to the this area.
company_amount
decimal
No
If you have a sub agent you can decide how much amount of transaciton will be transferred to your account.
add_commission
bool
No
You can post true If you want to add transaction commision to amount that charged on card.
transaction_type
int
No
Sales or pre-provision.1 for "sales", 3 for "pre-provision". Default is "sales".
ratio_code
string
No
You can see the ratio codes of ratio tables that you can define from the “API rate definitions ” at Paynet.com.tr management screens. Commision’s calculations performs on rate tables that belongs to the rate code that you post. Therefore you can do transactions that you wish which rates perform on.
save_card
bool
No
If you want to save your credit card with payment transactions,you can post this parameter as “true”.If you want to card saving operation,it is necessary to post card_desc and at least one of the card_owner_id or user_unique_id should be posted.
card_desc
string
No
This area is required if card saving operation will perform.
user_unique_id
string
No
Unique id that given to user by member workplace.It’s necessary If card saving will perform at first time.Unique value(card_owner_id) assigns to user by Paynet after completion first card saving operation. You must store this value on your system by associating it with your user. Afterwards you should use the card_owner_id variable given by Paynet instead of user_unique_id for the saved card operations.
card_owner_id
string
No
Unique card holder information that has been generated by Paynet residing on user_unique_id after the first card saving process. This value is also used in subsequent card saving and recieving payment processes.
user_gsm_no
string
No
This parameter is used if you want to make an additional OTP control whilst the card saving procces. Please contact our customer service if you want more specific information about this matter please contact with our support team.
subscription_id
string
No
Regular payment code, used with (invoice_no)if you want to recieve manual payment with a already existing regular payment.
invoice_no
string
No
Regular payment invoice number.
ratio_code_method
char
No
Please contact our customer service if you want more spesific information about this matter.
merge_option
bool
No
Please contact our customer service if you want more spesific information about this issue.
pos_type
int
No
Please contact our customer service if you want more spesific information about this issue.
approved_card
bool
No
Please contact our customer service if you want more spesific information about this matter.
is_escrow
bool
No
If you want the transaction to be approved by the company, you should send "true". If the parameter has not been sent, "false" is accepted.
Parameter
Type
Description
id
int
single paynet transaction id
xact_id
string
Reference no that related with payment transaction
xact_date
DateTime
Hash value of paynet transaction
transaction_type
int
Type of transaction; 1for sales, 3 for pre-provision
pos_type
int
Pos type
agent_id
string
Agent code
user_id
string
User code
email
string
Email address
phone
string
Phone number
bank_id
string
Bank Code
bank_name
string
Bank Name
instalment
int
Installment informations
ratio
float
Rate of transaction commision
card_no_masked
string
Card information of masked card
card_holder
string
Card holder
amount
decimal
Gross transaction amount
net_amount
decimal
Amount except commision
comission
decimal
Commision amount
currency
string
Currency
bank_authorization_code
string
Bank authorization code
bank_reference_code
string
Bank reference code
bank_order_id
string
Bank order number
is_succeed
bool
Whether transaction is success or not.If result true it means amount draw from card
code
string
Http status code
message
string
Transcation result message
paynet_error_id
string
Paynet error code
paynet_error_message
string
Paynet error explanation
bank_error_id
string
Error code that posted from bank
bank_error_message
string
Error code that posted from bank
bank_error_short_desc
string
Error code that posted from bank
bank_error_long_desc
string
Error code that posted from bank
reference_no
string
Reference code that posted during request
xact_transaction_id
string
Guid transaction code of that transaction, cancellation of this transaction,this area get same guid value during the refund transactions
campaign_url
string
At the some of the card programs selections of +installment or postponed intallments can be selected on the another applications after transaction
end_user_comission
decimal
Comission value on "ratio_code" usage
end_user_ratio
float
Comission rate on "ratio_code" usage
ratio_code
string
Ratio code
ratio_code_method
string
Ratio code method
is_save_card_succeed
bool
Result message shown if undergoing a card saving process
save_card_result_message
string
Card saving message
card_owner_id
string
Id that is going to be used in subsequent card saving processes
user_unique_id
string
Customers unique id number
card_hash
string
Card information that has been made a token
card_bank_id
string
Saved card bank id
card_logo_url
string
Saved card logo
1
{
2
"amount": 12.5,
3
"reference_no": "REF1000",
4
"domain": "paynet.com.tr",
5
"card_holder": "Paynet A.Ş",
6
"pan": "1212121212121212",
7
"month": "8",
8
"year": "2026",
9
"cvc": "000"
10
}
11
Copied!
1
{
2
"id": 20490**,
3
"xact_id": "**_EAAAAEBAN9wUFv0GvZ37KeP0ggCz*SafLumQCPN2Z1EDrs**",
4
"xact_date": "2018-12-14T13:33:53.1227309+03:00",
5
"transaction_type": 1,
6
"pos_type": 6,
7
"agent_id": "20077",
8
"user_id": "PaynetApi",
9
"email": null,
10
"phone": null,
11
"instalment": 0,
12
"ratio": 0.02,
13
"card_no_masked": "435508******4358",
14
"card_holder": "TEST TEST",
15
"amount": 12.5,
16
"net_amount": 12.25,
17
"comission": 0.25,
18
"comission_tax": 0,
19
"currency": "TRY",
20
"bank_id": "ZDGR",
21
"bank_name": "Maximum",
22
"bank_authorization_code": "aut-7044",
23
"bank_reference_code": "ref-7044",
24
"bank_order_id": "order-7044",
25
"is_succeed": true,
26
"paynet_error_id": "",
27
"paynet_error_message": "",
28
"bank_error_id": "",
29
"bank_error_message": "",
30
"bank_error_short_desc": "",
31
"bank_error_long_desc": "",
32
"reference_no": "deneme11",
33
"xact_transaction_id": "20490**",
34
"campaign_url": "",
35
"end_user_comission": 0,
36
"end_user_ratio": 0,
37
"ratio_code": "",
38
"ratio_code_method": "",
39
"is_save_card_succeed": false,
40
"save_card_result_message": "",
41
"card_owner_id": "",
42
"user_unique_id": "",
43
"card_hash": "",
44
"card_bank_id": "",
45
"card_logo_url": "",
46
"company_cost_ratio":"",
47
"company_commission":"",
48
"company_commission_with_tax":"",
49
"company_net_amount":"",
50
"plus_installment":"",
51
"card_type":"",
52
"card_brand_name":"",
53
"object_name": "payment_response",
54
"code": 0,
55
"message": "Başarılı İşlem"
56
}
Copied!
You can get transaction result whether success or not as checking is_succeed parameter.If is_succeed parameter return true result is success. For more information about error codes.
If you can not get a response due to reasons such as connection timeout or execution time out, you can continue the process with the same reference_no until you get an answer . The system returns the transaction if there is a previous successful transaction with the same reference_no. In this case, the result code returns 100 instead of 0, and the result message is returned as "Önceki Başarılı İşlem".
Look here for more information about card saving process.
Last modified 1yr ago
Copy link