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.

https://api.paynet.com.tr/v2/transaction/payment

Request Parameters

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.

Response Parameters

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

Request

{
    "amount": 12.5,
    "reference_no": "REF1000",
    "domain": "paynet.com.tr",
    "card_holder": "Paynet A.Ş",
    "pan": "1212121212121212",
    "month": "8",
    "year": "2026",
    "cvc": "000"
}

Response

{
    "id": 20490**,
    "xact_id": "**_EAAAAEBAN9wUFv0GvZ37KeP0ggCz*SafLumQCPN2Z1EDrs**",
    "xact_date": "2018-12-14T13:33:53.1227309+03:00",
    "transaction_type": 1,
    "pos_type": 6,
    "agent_id": "20077",
    "user_id": "PaynetApi",
    "email": null,
    "phone": null,
    "instalment": 0,
    "ratio": 0.02,
    "card_no_masked": "435508******4358",
    "card_holder": "TEST TEST",
    "amount": 12.5,
    "net_amount": 12.25,
    "comission": 0.25,
    "comission_tax": 0,
    "currency": "TRY",
    "bank_id": "ZDGR",
    "bank_name": "Maximum",
    "bank_authorization_code": "aut-7044",
    "bank_reference_code": "ref-7044",
    "bank_order_id": "order-7044",
    "is_succeed": true,
    "paynet_error_id": "",
    "paynet_error_message": "",
    "bank_error_id": "",
    "bank_error_message": "",
    "bank_error_short_desc": "",
    "bank_error_long_desc": "",
    "reference_no": "deneme11",
    "xact_transaction_id": "20490**",
    "campaign_url": "",
    "end_user_comission": 0,
    "end_user_ratio": 0,
    "ratio_code": "",
    "ratio_code_method": "",
    "is_save_card_succeed": false,
    "save_card_result_message": "",
    "card_owner_id": "",
    "user_unique_id": "",
    "card_hash": "",
    "card_bank_id": "",
    "card_logo_url": "",
    "company_cost_ratio":"",
    "company_commission":"",
    "company_commission_with_tax":"",
    "company_net_amount":"",
    "plus_installment":"",
    "card_type":"",
    "card_brand_name":"",
    "object_name": "payment_response",
    "code": 0,
    "message": "Başarılı İşlem"
}

Service Url

Sistem	Url
Live System	https://api.paynet.com.tr/v2/transaction/payment
Test System	https://pts-api.paynet.com.tr/v2/transaction/payment

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.