Get Started

Want to quickly experience SUNBAY payments? This guide provides simple examples to help you complete your first integration in 5 minutes.

Terminal Configuration

Set Operation Mode:

Before starting integration, ensure that the payment terminal has the Tapro application installed, then go to Settings → Operation Mode and set the mode to PinPad. In integration mode, the terminal receives orders dispatched from external systems through PinPad mode.

How It Works

Run Test

Use API Tester to quickly experience cloud payments without writing any code.

Step 1: Open API Documentation

Visit the Sale API Documentation to view interface specifications and parameter requirements.

Step 2: Use Try it Feature

1. Click the Try it button in the documentation to open API Tester
2. Fill in your API Key in Headers:

   Authorization: Bearer YOUR_API_KEY

3. Fill in payment request parameters in Request Body (variables can be auto-generated):

   {
     "appId": "your_app_id",
     "merchantId": "your_merchant_id",
     "referenceOrderId": "ORDER_123456",
     "transactionRequestId": "{{$transactionRequestId}}",
     "amount": {
       "orderAmount": 10000,
       "priceCurrency": "USD"
     },
     "description": "Test Payment",
     "terminalSn": "your_terminal_sn"
   }

4. Click Send Request to send the request
5. View Actual Request and Actual Response to understand the actual data sent and returned

Next Steps

Congratulations on completing your first payment experience! Next, you can: