Sipay ile Non-3DS ve 3D Secure Ödeme

Sipay yönetimi, üye işyeri web sitesinden gerçekleştirilen ödemelerin Non-3DS veya 3D Secure olarak işleme alınacağını belirler. Bu uç nokta (endpoint) için gönderilecek istek, üye işyerinin sunucusundan Sipay ödeme entegrasyon sistemine iletilmelidir.

Sipay’e POST yöntemiyle gönderilen cURL isteğinde, aşağıda belirtilen zorunlu parametreler bulunmalıdır.

Yanıt başarılı olduğunda kullanıcı, yanıtta dönen link değerine yönlendirilir. İşlem sonucu, return_url adresi üzerinden üye işyerine iletilir.

İşlem durumu aşağıdaki değerlere göre değerlendirilir:

payment_status == 1 ve transaction_type == "Auth"- İşlem başarılıdır ve tutar karttan anında tahsil edilir.

payment_status == 1 ve transaction_type == "Pre-Authorization" - İşlem başarılıdır ve tutar daha sonra karttan tahsil edilmek üzere ön provizyon olarak alınır.

payment_status == 0- İşlem başarısızdır.

Ödeme işleminin ardından son kullanıcı, aşağıda belirtilen parametreler kullanılarak üye işyerinin web sitesine yönlendirilir.

Yanıtın doğrulanabilmesi için hash_key parametresi gönderilir. Üye işyeri, aldığı hash_key değerini kendi tarafında oluşturduğu değerle karşılaştırarak isteğin Sipay’den geldiğini doğrulamalıdır.

Ek olarak, İşlem Durumu servisi kullanılarak işlemin başarılı veya başarısız olduğu doğrulanmalıdır.

Purchase/link ödeme başlatma istekleri, üye işyerinin sunucusundan server-to-server olarak gönderilmelidir. Erişim token’ı Authorization: Bearer {token} başlığında iletilmeli ve yalnızca sunucu tarafında tutulmalıdır.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location 'https://provisioning.sipay.com.tr/ccpayment/purchase/link' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "merchant_key": "$2y$10$HmRgYosneqcwHj.UH7upGuyCZqpQ1ITgSMj9Vvxn.t6f.Vdf2SQFO", "name": "Sipay", "surname": "Sipay", "currency_code": "TRY", "invoice": "{\"invoice_id\":\"5H1smeterg3rewt\",\"invoice_description\":\"POSTMAN - INVOICE TEST DESCRIPTION\",\"total\":\"100.00\",\"discount\":0,\"coupon\":null,\"return_url\":\"https://localhost:44381/servis/Odeme/Sipay/paylink.ashx?r=1\",\"cancel_url\":\"https://localhost:44381/servis/Odeme/Sipay/paylink.ashx?r=2\",\"is_comission_from_user\":1,\"commission_for_installment\":\"1,2,3,4,5,6,7,8,9,10,11,12\",\"items\":[{\"name\":\"Item\",\"price\":\"100.00\",\"quantity\":1,\"description\":\"item description\"}],\"bill_address1\":\"İstanbul Kadıköy\",\"bill_address2\":\"İstanbul Üsküdar\",\"bill_city\":\"İstanbul\",\"bill_postcode\":\"34734\",\"bill_state\":\"Bill State Example\",\"bill_email\":\"testtest@gmail.com\",\"bill_phone\":\"\",\"response_method\":\"POST\"}" }'

{ "status": true, "status_code": 100, "success_message": "Success !", "link": "https://provisioning.sipay.com.tr/ccpayment/makepayment/VP17697754816843201", "order_id": "VP17697754816843201" }

Request

Responses