Ödeme Başlatma

Ödeme başlatma servisinin isteğinde tahsil edilecek tutar ve kullanıcı listeleme servisinde listelenen kullanıcının eposta bilgisi iletilmektedir.

POST https://api.iyzipay.com/v2/in-store/payment

Headers

Parametre	Zorunluluk	Veri Tipi	Açıklama
x-api-key	Zorunlu	String	CepPOS API Anahtarı
x-secret-key	Zorunlu	String	CepPOS Güvenlik Anahtarı
x-merchant-id	Zorunlu	Integer	Üye İşyeri Numarası
x-callback-url	Zorunlu	String	İşlem sonrası uygulamanıza geri dönülmesi sağlayan parametredir.

İstek Parametreleri

Parametre	Zorunluluk	Veri Tipi	Açıklama
amount	Evet	Number	Tahsil edilmek istenen tutar.
email	Evet	String	CepPOS Güvenlik Anahtarı
paymentSource	Hayır	String	Üye iş yeri tarafından iletilen ödeme kaynağı bilgisi.

İstek Örneği

{
    "amount": "26",
    "email": "[email protected]",
    "paymentSource": "IYZICO"
}

Yanıt Parametreleri

Kullanıcı listeleme servisinden dönen parametreler aşağıdaki gibidir.

Parametre	Veri Tipi	Açıklama
status	String	Yapılan isteğin sonucunu bildirir.
errorCode	String	İşlem hatalıysa, bu hataya dair belirtilen koddur.
errorMessage	String	İşlem hatalıysa, bu hataya dair belirtilen mesajdır.
errorGroup	String	İşlem hatalıysa, bu hataya dair belirtilen gruptur.
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.
deepLinkUrl	String	Ceppos app'ini uyandırmak için kullanılan link.
paymentSessionToken	String	İşlem başlatılırken kullanılan benzersiz id'dir.
paymentId	Integer	Ödemenin iyzico tarafındaki işlem id'dir.

Yanıt Örneği

{
    "status": "success",
    "errorCode": null,
    "errorMessage": null,
    "errorGroup": null,
    "locale": null,
    "systemTime": 1724242498134,
    "conversationId": null,
    "deepLinkUrl": "https://www.iyzico.com/payment?paymentSessionToken=6FD0C73A962E6C82",
    "paymentSessionToken": "6FD0C73A962E6C82",
    "paymentId": 22624085
}

Yanıtta yer alan deepLinkUrl parametre değeri ile cihazınızda yüklü olan Ceppos uygulamasını uyandırarak temassız ödeme işleminizi başlatabilirsiniz.

İşlem tamamlandığında headersta iletilen x-callback-url değerindeki linke yönlendirme olacaktır. Bu linkte ödeme sonucunu sorgulayabilirsiniz.