Ödeme Başlatma

Ödeme süreci /payment/init endpoint'i ile başlar. Başarılı bir istek, müşteriyi iyzico mobil uygulamasına yönlendiren bir deepLinkUrl ve sonraki adımda şifre çözmek için kullanılacak bir paymentSessionToken döner. Müşteri uygulamayı açıp ödemeyi onayladıktan sonra sonuç, sizin belirlediğiniz x-callback-url adresine şifreli olarak iletilir.

Ödeme Başlatma

post

https://sandbox-api.iyzipay.com/v3/in-storehttps://api.iyzipay.com/v3/in-store

/payment/init

Mağaza içi bir ödeme işlemini başlatmak için kullanılır.

Header parameters

x-api-keystringRequired

iyzico panelinizdeki CepPOS API anahtarı

Example: YOUR_API_KEY

x-secret-keystringRequired

iyzico panelinizdeki CepPOS güvenlik anahtarı

Example: YOUR_SECRET_KEY

x-merchant-idstringRequired

iyzico hesabınızın üye işyeri numarası

Example: YOUR_MERCHANT_ID

x-callback-urlLongRequired

Sorgulanacak ödemenin ID'si

Example: 1000001

Body

application/json

userIdnumber · floatRequired

Ödemeyi yapacak kullanıcı ID'si

Example: user-1

orderIdstringRequired

Sipariş referans numarası

Example: ord_98765

amountstringRequired

Ödeme tutarı

Example: 150

Responses

200

Ödeme başarıyla başlatıldı

application/json

statusstringOptional

İşlemin sonucunu gösterir. Başarılı durumlarda "success" döner.

Example: success

deepLinkUrlstringOptional

Ödeme oturumuna özgü token. Ödeme tamamlandıktan sonra /crypt/decrypt adımında şifre çözmek için kullanılır.

Example: iyzico://payment?token=abc123

paymentSessionTokenstringOptional

Müşterinin iyzico mobil uygulamasına yönlendirileceği deep link URL'i. Bu link açıldığında uygulama ödeme ekranını başlatır.

Example: abc123xyz

paymentIdstringOptional

iyzico tarafından atanan benzersiz ödeme kimliği. İade ve sorgulama işlemlerinde referans olarak kullanılır.

Example: 1000001

400

Hatalı istek veya doğrulama hatası

application/json

post/payment/init

HTTPcURLJavaScriptPython

POST /v3/in-store/payment/init HTTP/1.1
Host: sandbox-api.iyzipay.com
x-api-key: YOUR_API_KEY
x-secret-key: YOUR_SECRET_KEY
x-merchant-id: YOUR_MERCHANT_ID
x-callback-url: 1000001
Content-Type: application/json
Accept: */*
Content-Length: 54

{
  "userId": "user-1",
  "orderId": "ord_98765",
  "amount": 150
}

{
  "status": "success",
  "deepLinkUrl": "iyzico://payment?token=abc123",
  "paymentSessionToken": "abc123xyz",
  "paymentId": "1000001"
}