Onay

Pazaryeri çözümünde, ödeme iyzico’dan geçtikten sonra, üye işyeri ödeme içinde yer alan kırılıma / ürüne onay verene dek para korumalı havuz hesapta bekletilir. Üye işyeri bu sürede ödemeyi iptal edebilir, ödemenin kırılımını iade edebilir ya da ürün alıcıya ulaştı ve işlem sorunsuz tamamlandıysa para transferi için ürüne onay verebilir veya verdiği ürün onayını geri çekebilir.

Pazaryeri çözümlerinde bir ödemenin alt kırılımına iki çeşit onay seçeneği uygulanabilir.

1. Onay Verme

2. Onay Kaldırma

Ürünlere onay verme iyzico tarafından yapılamamaktadır. Kontrol panelinde bu şekilde bir fonksiyon olmadığından kod seviyesinde bu onaylar gönderilmelidir.

Onay Verme

Ürüne onay vermek için ödeme kırılımına ait id (paymentTransactionId) iletilmesi gerekmektedir. Onay verilen ödeme kırılımı id’si (paymentTransactionId) servisten döner.

Onay Verme

POST https://api.iyzipay.com/payment/iyzipos/item/approve

Request Body

Name	Type	Description
locale	String	iyzico istek sonucunda dönen metinlerin dilini ayarlamak için kullanılır. Varsayılan değeri tr’dir.
conversationId	String	İstek esnasında gönderip, sonuçta alabileceğiniz bir değer, request/response eşmesi yapmak için kullanılabilir.
paymentTransactionId*	String	Ödeme kırılımına ait ürünün iyzico taradından belirlenmiş unique id'si.

200: OK

Onay Verme Yanıtı

{
    "status":"success",
    "locale":"tr",
    "systemTime":1686434789050,
    "conversationId":"123456789",
    "paymentTransactionId":"20947103"
}

Onay Verme Dönen Parametreler

Parametre ismi	Tip	Açıklama
status	String	Yapılan isteğin sonucunu bildirir. İşlem başarılı ise success, hatalı ise failure döner.
locale	String	İstekte belirtilen locale değeri geri dönülür, varsayılan değeri tr'dir.
systemTime	Integer	Dönen sonucun o anki unix timestamp değeridir.
conversationId	String	İstek esnasında gönderilmişse, sonuçta aynen geri iletilir.
paymentTransactionId	String	Ödeme kırılımına ait ürünün iyzico taradından belirlenmiş unique id'si.
errorCode	String	İşlem hatalıysa, bu hataya dair belirtilen koddur.
errorMessage	String	İşlem hatalıysa, bu hataya dair belirtilen mesajdır, locale parametresine göre dil desteği sunar.
errorGroup	String	İşlem hatalıysa, bu hataya dair belirtilen gruptur.

Onay Verme Örnek Request

PHP

$request = new \Iyzipay\Request\CreateApprovalRequest();
$request->setLocale(\Iyzipay\Model\Locale::TR);
$request->setConversationId("123456789");
$request->setPaymentTransactionId("1");

$approval = \Iyzipay\Model\Approval::create($request, Config::options());

.NET

CreateApprovalRequest request = new CreateApprovalRequest();
request.Locale = Locale.TR.ToString();
request.ConversationId = "123456789";
request.PaymentTransactionId = "1";

Approval approval = Approval.Create(request, options);

JAVA

CreateApprovalRequest request = new CreateApprovalRequest();
request.setLocale(Locale.TR.getValue());
request.setConversationId("123456789");
request.setPaymentTransactionId("1");

Approval approval = Approval.create(request, options);

NodeJS

iyzipay.approval.create({
    locale: Iyzipay.LOCALE.TR,
    conversationId: "123456789",
    paymentTransactionId: "1"
}, function (err, result) {
    console.log(err, result);
    done();
});

Python

request = dict([('locale', 'tr')])
request['conversationId'] = '123456789'
request['paymentTransactionId'] = '1'

approval = iyzipay.Approval()
approval_response = approval.create(request, options)

Ruby

request = {
    locale: 'tr',
    conversationId: '123456789',
    paymentTransactionId: '699'
}
approval = Iyzipay::Model::Approval.new.create(request, @options)

JSON

//Request
{
    "locale": "tr",
    "conversationId": "123456789",
    "paymentTransactionId": "38248"
}

//Response
{
    "status": "success",
    "locale": "tr",
    "systemTime": 1470733388749,
    "conversationId": "123456789",
    "paymentTransactionId": "38248"
}

Onay Kaldırma

Ürüne verilen onayı geri çekmek için ödeme kırılımına ait id (paymentTransactionId) iletilmesi gerekmektedir. Onayı geri çekilen ödeme kırılımı id’si (paymentTransactionId) servisten döner.

Onay Kaldırma

POST https://api.iyzipay.com/payment/iyzipos/item/disapprove

Request Body

Name	Type	Description
locale	String	iyzico istek sonucunda dönen metinlerin dilini ayarlamak için kullanılır. Varsayılan değeri tr’dir.
conversationId	String	İstek esnasında gönderip, sonuçta alabileceğiniz bir değer, request/response eşmesi yapmak için kullanılabilir.
paymentTransactionId*	String	Ödeme kırılımına ait ürünün iyzico taradından belirlenmiş unique id'si.

200: OK

Onay Kaldırma Yanıtı

{
    "status":"success",
    "locale":"tr",
    "systemTime":1686434789050,
    "conversationId":"123456789",
    "paymentTransactionId":"20947103"
}

Onay Kaldırma Dönen Parametreler

Parametre ismi	Tip	Açıklama
status	String	Yapılan isteğin sonucunu bildirir. İşlem başarılı ise success, hatalı ise failure döner.
locale	String	İstekte belirtilen locale değeri geri dönülür, varsayılan değeri tr'dir.
systemTime	Integer	Dönen sonucun o anki unix timestamp değeridir.
conversationId	String	İstek esnasında gönderilmişse, sonuçta aynen geri iletilir.
paymentTransactionId	String	Ödeme kırılımına ait ürünün iyzico taradından belirlenmiş unique id'si.
errorCode	String	İşlem hatalıysa, bu hataya dair belirtilen koddur.
errorMessage	String	İşlem hatalıysa, bu hataya dair belirtilen mesajdır, locale parametresine göre dil desteği sunar.
errorGroup	String	İşlem hatalıysa, bu hataya dair belirtilen gruptur.

Onay Kaldırma Örnek Request

PHP

$request = new \Iyzipay\Request\CreateApprovalRequest();
$request->setLocale(\Iyzipay\Model\Locale::TR);
$request->setConversationId("123456789");
$request->setPaymentTransactionId("1");

$disapproval = \Iyzipay\Model\Disapproval::create($request, Config::options());

.NET

CreateApprovalRequest request = new CreateApprovalRequest();
request.Locale = Locale.TR.ToString();
request.ConversationId = "123456789";
request.PaymentTransactionId = "1";

Disapproval disapproval = Disapproval.Create(request, options);

JAVA

CreateApprovalRequest request = new CreateApprovalRequest();
request.setLocale(Locale.TR.getValue());
request.setConversationId("123456789");
request.setPaymentTransactionId("1");

Disapproval disapproval = Disapproval.create(request, options);

NodeJS

iyzipay.disapproval.create({
    locale: Iyzipay.LOCALE.TR,
    conversationId: '123456789',
    paymentTransactionId: '1'
}, function (err, result) {
    console.log(err, result);
    done();
});

Python

request = dict([('locale', 'tr')])
request['conversationId'] = '123456789'
request['paymentTransactionId'] = '1'

disapproval = iyzipay.Disapproval()
disapproval_response = disapproval.create(request, options)

Ruby

request = {
    locale: 'tr',
    conversationId: '123456789',
    paymentTransactionId: '699'
}
disapproval = Iyzipay::Model::Disapproval.new.create(request, @options)

JSON

//Request
{
    "locale": "tr",
    "conversationId": "123456789",
    "paymentTransactionId": "38248"
}

//Response
{
    "status": "success",
    "locale": "tr",
    "systemTime": 1470733437268,
    "conversationId": "123456789",
    "paymentTransactionId": "38248"
}