API - NON3D
Initiates a payment without 3D Secure.
Authorization header starting with IYZWSv2 and a signed hash value encoded in base64.
IYZWSv2 aXBzaWduYXR1cmU...
Content-Type value.
application/json
Unique ID used to match request/response.
conversationId
Language code. Allowed values; tr, en. Default; tr
en
Possible values: Total amount to be charged from the buyer.
1
Basket total amount.
1
Payment group. Default; PRODUCT.
PRODUCT
Possible values: Currency. Default; TRY.
TRY
Possible values: Installment count. If omitted, single payment (1) is applied.
Basket ID.
B67832
Payment channel.
WEB
Possible values: Successful response
Invalid request / validation error
POST https://api.iyzipay.com/payment/auth
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json
{
"conversationId":"conversationId",
"locale":"en",
"paidPrice":1.0,
"price":1.0,
"paymentGroup":"PRODUCT",
"currency":"TRY",
"basketId":"B67832",
"paymentChannel":"WEB",
"installment": 1,
"paymentCard":{
"cardHolderName":"John Doe",
"cardNumber":"5528790000000008",
"expireMonth":"12",
"expireYear":"2030",
"cvc":"123",
"registerCard":0
},
"buyer":{
"id":"BY789",
"name":"John",
"surname":"Doe",
"identityNumber":"74300864791",
"email":"[email protected]",
"gsmNumber":"+905350000000",
"registrationDate":"2013-04-21 15:12:09",
"lastLoginDate":"2015-10-05 12:43:35",
"registrationAddress":"Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1",
"city":"Istanbul",
"country":"Turkey",
"zipCode":"34732",
"ip":"85.34.78.112"
},
"shippingAddress":{
"address":"Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1",
"zipCode":"34742",
"contactName":"Jane Doe",
"city":"Istanbul",
"country":"Turkey"
},
"billingAddress":{
"address":"Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1",
"zipCode":"34742",
"contactName":"Jane Doe",
"city":"Istanbul",
"country":"Turkey"
},
"basketItems":[
{
"id":"BI101",
"price":0.3,
"name":"Binocular",
"category1":"Collectibles",
"category2":"Accessories",
"itemType":"PHYSICAL"
}
]
}
{
"status": "success",
"locale": "en",
"systemTime": 1700000000000,
"conversationId": "conversationId",
"price": 1,
"paidPrice": 1,
"installment": 1,
"paymentId": "25147713",
"fraudStatus": 1,
"merchantCommissionRate": "0E-8",
"merchantCommissionRateAmount": "0E-8",
"iyziCommissionRateAmount": 0.0349,
"iyziCommissionFee": 0.25,
"cardType": "CREDIT_CARD",
"cardAssociation": "MASTER_CARD",
"cardFamily": "Axess",
"binNumber": "552879",
"lastFourDigits": "0008",
"basketId": "B67832",
"currency": "TRY",
"itemTransactions": [
{
"itemId": "BI101",
"paymentTransactionId": "27137212",
"transactionStatus": 2,
"price": 0.3,
"paidPrice": 0.3,
"merchantCommissionRate": "0E-8",
"merchantCommissionRateAmount": "0E-8",
"iyziCommissionRateAmount": 0.01047,
"iyziCommissionFee": 0.075,
"blockageRate": "0E-8",
"blockageRateAmountMerchant": "0E-8",
"blockageRateAmountSubMerchant": "0E-8",
"blockageResolvedDate": "2025-08-22 00:00:00",
"subMerchantPrice": 0,
"subMerchantPayoutRate": "0E-8",
"subMerchantPayoutAmount": 0,
"merchantPayoutAmount": 0.21453,
"convertedPayout": {
"paidPrice": 0.3,
"iyziCommissionRateAmount": 0.01047,
"iyziCommissionFee": 0.075,
"blockageRateAmountMerchant": "0E-8",
"blockageRateAmountSubMerchant": "0E-8",
"subMerchantPayoutAmount": "0E-8",
"merchantPayoutAmount": 0.21453,
"iyziConversionRate": 0,
"iyziConversionRateAmount": 0,
"currency": "TRY"
}
}
],
"authCode": "579803",
"phase": "AUTH",
"hostReference": "mock00007iyzihostrfn",
"signature": "5ab609ed2e0f4cae0035c8c136d29b00c2616cf8fb4856df65bb52b5a796369f"
}
Retrieves the result of a payment.
Authorization header starting with IYZWSv2 and a signed hash value encoded in base64.
IYZWSv2 aXBzaWduYXR1cmU...
Content-Type value.
application/json
Language code. Allowed values; tr, en. Default; tr
en
Possible values: Payment transaction ID.
25168803
ConversationId of the payment transaction. Required if paymentId is not sent.
123456789
Successful response
Invalid request / validation error
POST https://api.iyzipay.com/payment/detail
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json
{
"paymentId":"25168803",
"paymentConversationId":"123456789"
}
{
"status": "success",
"locale": "en",
"systemTime": 1700000000000,
"conversationId": "123456789",
"paymentId": "1",
"price": 1,
"paidPrice": 1,
"installment": 1,
"fraudStatus": 1,
"merchantCommissionRate": "0E-8",
"merchantCommissionRateAmount": "0E-8",
"iyziCommissionRateAmount": 0.0349,
"iyziCommissionFee": 0.25,
"cardType": "CREDIT_CARD",
"cardAssociation": "MASTER_CARD",
"cardFamily": "Axess",
"binNumber": "552879",
"lastFourDigits": "0008",
"basketId": "B67832",
"currency": "TRY",
"itemTransactions": [
{
"itemId": "BI101",
"paymentTransactionId": "27137212",
"transactionStatus": 2,
"price": 0.3,
"paidPrice": 0.3,
"merchantCommissionRate": "0E-8",
"merchantCommissionRateAmount": "0E-8",
"iyziCommissionRateAmount": 0.01047,
"iyziCommissionFee": 0.075,
"blockageRate": "0E-8",
"blockageRateAmountMerchant": "0E-8",
"blockageRateAmountSubMerchant": "0E-8",
"blockageResolvedDate": "2025-08-22 00:00:00",
"subMerchantPrice": 0,
"subMerchantPayoutRate": "0E-8",
"subMerchantPayoutAmount": 0,
"merchantPayoutAmount": 0.21453,
"convertedPayout": {
"paidPrice": 0.3,
"iyziCommissionRateAmount": 0.01047,
"iyziCommissionFee": 0.075,
"blockageRateAmountMerchant": "0E-8",
"blockageRateAmountSubMerchant": "0E-8",
"subMerchantPayoutAmount": "0E-8",
"merchantPayoutAmount": 0.21453,
"iyziConversionRate": 0,
"iyziConversionRateAmount": 0,
"currency": "TRY"
}
}
],
"authCode": "579803",
"phase": "AUTH",
"hostReference": "mock00007iyzihostrfn",
"signature": "5ab609ed2e0f4cae0035c8c136d29b00c2616cf8fb4856df65bb52b5a796369f",
"paymentStatus": "SUCCESS"
}
Last updated