1. Commission
SA
  • Overview
    • Getting Started
  • Authentication
    • Token Generation
      POST
  • Commission
    • Commission
      POST
  • HASH
    • Hash Creation
    • Hash Validation
  • Non-Secure Payment
    • Non-Secure Payment Flow
    • Non-Secure Card Payment
      POST
    • Non-Secure Pre-Authorization Payment
      POST
    • Confirm Payment
      POST
  • 3D Secure Payment
    • 3D Secure Payment Flow
    • 3D Secure Card Payment
      POST
    • 3D Secure Pre-Authorization Payment
      POST
    • Complete Payment
      POST
    • Confirm Payment
      POST
  • Non-Secure and 3D Payment with Sipay
    • Non-Secure and 3D Secure Payment with Sipay
      POST
  • Check Status
    • Check Status
      POST
  • Refund
    • Refund
      POST
  • Webhook
    • Webhook
  • Status Codes
    • Status Codes
  1. Commission

Commission

Testing
POST
/ccpayment/api/commissions
This endpoint returns the merchant commission and the end-user commission according to the card program and the specified currency code.
commission_by: "merchant"
commission_by: "user"
Authorization is required, and the request must be made using the Bearer authentication method.

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

🟠401Failed
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://test01-app.sipay.co.za//ccpayment/api/commissions' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "currency_code": "TRY",
  "commission_by": "merchant",
  "app_lang": "en"
}'
Response Response Example
200 - Success
{
    "status_code": 100,
    "status_description": "successful",
    "data": {
        "1": [
            {
                "title": "Regular Commission",
                "card_program": "World",
                "merchant_commission_percentage": "0.0000",
                "merchant_commission_fixed": "0.0000",
                "user_commission_percentage": 0,
                "user_commission_fixed": 0,
                "currency_code": "TRY",
                "installment": 1,
                "pos_id": 76,
                "getpos_card_program": "WORLD"
            },
            {
                "title": "Regular Commission",
                "card_program": "Maximum",
                "merchant_commission_percentage": "2.0000",
                "merchant_commission_fixed": "0.0000",
                "user_commission_percentage": 0,
                "user_commission_fixed": 0,
                "currency_code": "TRY",
                "installment": 1,
                "pos_id": 76,
                "getpos_card_program": "MAXIMUM"
            },
            {
                "title": "Regular Commission",
                "card_program": "Bonus",
                "merchant_commission_percentage": "0.0000",
                "merchant_commission_fixed": "0.0000",
                "user_commission_percentage": 0,
                "user_commission_fixed": 0,
                "currency_code": "TRY",
                "installment": 1,
                "pos_id": 76,
                "getpos_card_program": "BONUS"
            },
            {
                "title": "Save Card Token Payment Commission",
                "card_program": "",
                "merchant_commission_percentage": 10,
                "merchant_commission_fixed": 0,
                "user_commission_percentage": "-",
                "user_commission_fixed": "-",
                "currency_code": "TRY",
                "installment": 1
            },
            {
                "title": "Foreign Card Commission",
                "card_program": "",
                "merchant_commission_percentage": 1,
                "merchant_commission_fixed": 0,
                "user_commission_percentage": 0,
                "user_commission_fixed": 0,
                "currency_code": "TRY",
                "installment": 1
            }
        ],
        "2": [
            {
                "title": "Regular Commission",
                "card_program": "World",
                "merchant_commission_percentage": "0.0000",
                "merchant_commission_fixed": "0.0000",
                "user_commission_percentage": 0,
                "user_commission_fixed": 0,
                "currency_code": "TRY",
                "installment": 2,
                "pos_id": 76,
                "getpos_card_program": "WORLD"
            },
            {
                "title": "Regular Commission",
                "card_program": "Maximum",
                "merchant_commission_percentage": "4.0000",
                "merchant_commission_fixed": "0.0000",
                "user_commission_percentage": 0,
                "user_commission_fixed": 0,
                "currency_code": "TRY",
                "installment": 2,
                "pos_id": 76,
                "getpos_card_program": "MAXIMUM"
            },
            {
                "title": "Regular Commission",
                "card_program": "Bonus",
                "merchant_commission_percentage": "0.0000",
                "merchant_commission_fixed": "0.0000",
                "user_commission_percentage": 0,
                "user_commission_fixed": 0,
                "currency_code": "TRY",
                "installment": 2,
                "pos_id": 76,
                "getpos_card_program": "BONUS"
            }
        ],
        "3": [
            {
                "title": "Regular Commission",
                "card_program": "World",
                "merchant_commission_percentage": "0.0000",
                "merchant_commission_fixed": "0.0000",
                "user_commission_percentage": 0,
                "user_commission_fixed": 0,
                "currency_code": "TRY",
                "installment": 3,
                "pos_id": 76,
                "getpos_card_program": "WORLD"
            },
            {
                "title": "Regular Commission",
                "card_program": "Maximum",
                "merchant_commission_percentage": "6.0000",
                "merchant_commission_fixed": "0.0000",
                "user_commission_percentage": 0,
                "user_commission_fixed": 0,
                "currency_code": "TRY",
                "installment": 3,
                "pos_id": 76,
                "getpos_card_program": "MAXIMUM"
            },
            {
                "title": "Regular Commission",
                "card_program": "Bonus",
                "merchant_commission_percentage": "0.0000",
                "merchant_commission_fixed": "0.0000",
                "user_commission_percentage": 0,
                "user_commission_fixed": 0,
                "currency_code": "TRY",
                "installment": 3,
                "pos_id": 76,
                "getpos_card_program": "BONUS"
            }
        ],
        "4": [
            {
                "title": "Regular Commission",
                "card_program": "World",
                "merchant_commission_percentage": "0.0000",
                "merchant_commission_fixed": "0.0000",
                "user_commission_percentage": 0,
                "user_commission_fixed": 0,
                "currency_code": "TRY",
                "installment": 4,
                "pos_id": 76,
                "getpos_card_program": "WORLD"
            },
            {
                "title": "Regular Commission",
                "card_program": "Maximum",
                "merchant_commission_percentage": "8.0000",
                "merchant_commission_fixed": "0.0000",
                "user_commission_percentage": 0,
                "user_commission_fixed": 0,
                "currency_code": "TRY",
                "installment": 4,
                "pos_id": 76,
                "getpos_card_program": "MAXIMUM"
            },
            {
                "title": "Regular Commission",
                "card_program": "Bonus",
                "merchant_commission_percentage": "0.0000",
                "merchant_commission_fixed": "0.0000",
                "user_commission_percentage": 0,
                "user_commission_fixed": 0,
                "currency_code": "TRY",
                "installment": 4,
                "pos_id": 76,
                "getpos_card_program": "BONUS"
            }
        ],
        "5": [
            {
                "title": "Regular Commission",
                "card_program": "World",
                "merchant_commission_percentage": "0.0000",
                "merchant_commission_fixed": "0.0000",
                "user_commission_percentage": 0,
                "user_commission_fixed": 0,
                "currency_code": "TRY",
                "installment": 5,
                "pos_id": 76,
                "getpos_card_program": "WORLD"
            },
            {
                "title": "Regular Commission",
                "card_program": "Maximum",
                "merchant_commission_percentage": "12.0000",
                "merchant_commission_fixed": "0.0000",
                "user_commission_percentage": 0,
                "user_commission_fixed": 0,
                "currency_code": "TRY",
                "installment": 5,
                "pos_id": 76,
                "getpos_card_program": "MAXIMUM"
            },
            {
                "title": "Regular Commission",
                "card_program": "Bonus",
                "merchant_commission_percentage": "x",
                "merchant_commission_fixed": "x",
                "user_commission_percentage": "x",
                "user_commission_fixed": "x",
                "currency_code": "TRY",
                "installment": 5,
                "pos_id": 76,
                "getpos_card_program": "BONUS"
            }
        ],
        "6": [
            {
                "title": "Regular Commission",
                "card_program": "World",
                "merchant_commission_percentage": "x",
                "merchant_commission_fixed": "x",
                "user_commission_percentage": "x",
                "user_commission_fixed": "x",
                "currency_code": "TRY",
                "installment": 6,
                "pos_id": 123,
                "getpos_card_program": "WORLD"
            },
            {
                "title": "Regular Commission",
                "card_program": "Maximum",
                "merchant_commission_percentage": "14.0000",
                "merchant_commission_fixed": "0.0000",
                "user_commission_percentage": 0,
                "user_commission_fixed": 0,
                "currency_code": "TRY",
                "installment": 6,
                "pos_id": 123,
                "getpos_card_program": "MAXIMUM"
            },
            {
                "title": "Regular Commission",
                "card_program": "Bonus",
                "merchant_commission_percentage": "x",
                "merchant_commission_fixed": "x",
                "user_commission_percentage": "x",
                "user_commission_fixed": "x",
                "currency_code": "TRY",
                "installment": 6,
                "pos_id": 123,
                "getpos_card_program": "BONUS"
            }
        ]
    }
}
Modified at 2026-04-29 07:20:15
Previous
Commission
Next
Hash Creation
Built with