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

Refund

Testing
Testing Env
https://provisioning.sipay.com.tr
Testing Env
https://provisioning.sipay.com.tr
POST
/ccpayment/api/refund
It is used to request a refund for a transaction that has already been paid for.

Partial Refunds#

For partial refund operations, the amount field must include the exact amount to be refunded.
If the full transaction amount is submitted in the refund request, the transaction status will be updated as refund.
For example, if a transaction amount is 10 TRY and a refund of 7 TRY is issued, the transaction status will be updated as partially_refund.
There is no need to send a request to a separate endpoint for void operations. For same-day transactions, void operations are processed by sending a request to the refund endpoint.

Request

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

Examples

Responses

🟢200Success
application/json
Body

🔵31Failed
🟠49Failed
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://provisioning.sipay.com.tr/ccpayment/api/refund' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "invoice_id": "Cs2Ghy621dsa42f1D2",
  "amount": 125,
  "app_id": "6d4a7e9374a76c15260fcc75e315b0b9",
  "app_secret": "b46a67571aa1e7ef5641dc3fa6f1712a",
  "merchant_key": "$2y$10$HmRgYosneqcwHj.UH7upGuyCZqpQ1ITgSMj9Vvxn.t6f.Vdf2SQFO",
  "hash_key": "661ebbf2acc9d8bc:cb27:47tnM4SnmuVWRq9YMaHo2npFjXr7Nfe04poc_ri3g_R1NylhHZcj0Zu3Eul",
  "refund_transaction_id": "",
  "refund_web_hook_key": "string",
  "app_lang": "en"
}'
Response Response Example
200 - Success
{
    "status_code": 100,
    "status_description": "Refund completed successfully",
    "order_no": "VP17695816358637973",
    "invoice_id": "CPIKQUM29TXMQFF-1769581631",
    "ref_no": "602800085396",
    "ref_number": "602800085396"
}
Modified at 2026-03-31 11:01:38
Previous
Non-Secure and 3D Payment with Sipay
Next
Card Registration
Built with