1. Payment
Sipay API Documentation
  • Overview
    • Getting Started
    • Status Codes
    • PreAuthorization / Authorization
    • Webhook
  • Authentication
    • Generating Token
      POST
  • Installments
    • Getting Installment Information
      POST
    • Installments
      POST
  • Commissions
    • Commission
      POST
  • Non Secure Payment
    • Non-Secure Payment Flow
    • Non-Secure Credit Card Payment
      POST
    • Non-Secure Recurring Payment
      POST
    • Non-Secure Insurance Payment
      POST
    • Non-Secure PreAuthorization Payment
      POST
  • 3D Secure Payment
    • 3D Secure Payment Flow
    • 3D Secure Credit Card Payment
      POST
    • 3D Secure Recurring Payment
      POST
    • 3D Secure PreAuthorization Payment
      POST
    • 3D Secure PreAuthorization Payment APP
      POST
    • 3D Secure Agriculture Payment
      POST
  • Payment
    • CheckStatus
      POST
    • ConfirmPayment
      POST
    • CompletePayment
      POST
    • Non-Secure and 3D Payment with Sipay
      POST
    • Refund
      POST
  • Cards
    • Card Registration
    • Pay by Card Token
    • Retrieving Saved Card
    • Edit Saved Card
    • Delete Saved Card
    • NonSecure Payment with Hidden Card
  • HASH
    • Hash Information
  • Recurring
    • Recurring Query Search
    • Recurring Plan Process
    • Recurring Plan Update
  • Cashout
    • Cashout to bank
  • Report
    • Settlement API
  1. Payment

Non-Secure and 3D Payment with Sipay

Testing
Testing Env
https://provisioning.sipay.com.tr
Testing Env
https://provisioning.sipay.com.tr
POST
/ccpayment/purchase/link
The Sipay administrator will decide whether the payment made from the merchant website should be Non-Secure or 3D Secure. The following request should be sent from the merchant website to the Sipay payment integration system. The CURL POST request should be received in Sipay with the following parameters:
If the response is successful, a redirection is made to the link value, and the user should check the Transaction Status in the return_url they receive.
Status 1: payment_status == 1 and transaction_type == “Auth” // The transaction is successful and the amount will be deducted from the card immediately.
Status 2: payment_status == 1 and transaction_type == “Pre-Authorization” // The transaction is successful, and the amount will be deducted from the card later.
Status 3: payment_status == 0 // The transaction failed.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/jsonRequired

Examples

Responses

🟢200Success
application/json
Body

🟠400Failed
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '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\"}"

}'
Response Response Example
200 - Missing Field
{
    "status": false,
    "status_code": 1,
    "success_message": "The currency code field is required.",
    "link": null,
    "order_id": ""
}
Modified at 2026-01-30 12:28:57
Previous
CompletePayment
Next
Refund
Built with