1. Overview
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. Overview

Status Codes

Server Status Codes#

This is the response code provided by the API server over the HTTP protocol.
Status CodeDescription
200OK
201Created
202Accepted (Request accepted and queued for action)
400Invalid request
401Authentication error
403Forbidden
404Source not found
405Method not found
409Conflict
412Prerequisite failed
413Too much demand content
500Internal Server Error
501Not applied
503Service Unavailable

Application Status Codes#

The code generated by the API application within its own logic, showing the result of processing the request.
Status CodeDescription
1Basic validation
3Invoice ID already processed
3Order with this invoice ID ".$invoice_id." process continues,
3Please wait or create order with new invoice id
12Items must be an array, Invalid Currency code, Invalid item format
13The sum of your product price ("5") does not equal the total of the invoice ("10")
14Merchant not found!
30Invalid Credentials
31Transaction not found
32Invalid invoice ID, order not completed
33Quantity must be integer
34Payment integration method not allowed. Please contact support.
35Credit Card Payment Option not defined
36POS not found
37Merchant Pos Commission has not been set. Please contact the service provider.
38Merchant Commission has not been determined for this currency and payment method.
38Please try another payment method
39Commission not found
40Installment not found
41Order failed
41Payment failed
42Product price less than commission or cost
43Payment term not set
44This credit card has been blocked
44Merchant daily transaction limit exceeded
45Merchant daily transaction amount limit exceeded
46Merchant monthly transaction number limit exceeded
47Merchant monthly transaction amount limit exceeded
48Minimum transaction limit per transaction violated
49Refund failed
49Total refund amount must not exceed the net amount
49No sales transaction found
49Insufficient balance
49Non-refundable transaction status
49Please wait at least 30 seconds before another refund
49Maximum transaction limit per transaction violated
55There can be no installment sales in recurring payment
55Duplicate number cannot be empty
55Duplicate number must be an integer
55Duplicate number must be greater than 1
55Duplicate number must not be greater than 121
55Iterative loop cannot be empty
55Repeating loop unit is not valid. Must be "D", "M", or "Y"
55Duplicate range cannot be empty
55Repeating range must be an integer
55Repeating range must be greater than 0
55Repeating range must not be greater than 99
55Invalid duplicate webhook key,Please check the key name in Sipay
55Duplicate webhook key cannot be empty, Please assign your webhook key to Sipay
56Invalid sale webhook key
60The merchant is not allowed to make transactions using this card
68Total amount mismatch with hash key
68Currency mismatch with hash key
68Hash key and merchant key mismatch
68Installment number mismatch with hash key
68Hash key and POS ID mismatch
68Invoice ID mismatch with hash key
69Order not yet processed
70Card program mismatch
71Recurring plan update failed
72Failed to delete or process old payment
73Failed to add duplicate plan card
76Foreign cards are not allowed for this merchant
77No foreign card commission defined for this merchant
79Merchant is not allowed to pay with card tokens
80Sub-merchant not found
81Currency conversion from API failed
85Invalid character
86Card token save failed
87Invalid token or client number
88Failed to delete card token
89Failed to update card token
90Invalid hash key
91Hash key does not match merchant key
92Hash key does not match customer number
93Hash key does not match card holder name
94Hash key does not match card number
95Hash key does not match expiration month
96Hash key does not match expiration year
97Hash key does not match card token
99Unknown error
100Successful
101Refund request created successfully
102POS not defined for this installment
103Pay-by-token commission rate not established
104Return transaction ID must be unique
105Transaction has not been approved
106Invalid merchant type
107Failed to verify submitted API operation
108Invalid card number
109File processing error
110Partial refunds are not allowed for this transaction
112Partially successful
117Invoice ID already processed
404Cancellation URL should not be blank
Modified at 2026-03-10 10:35:33
Previous
Getting Started
Next
PreAuthorization / Authorization
Built with