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
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"
}

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.