GoPay Merchant Bridge
GoMerchant API
The GoMerchant API allows you to automate GoPay collections by bridging directly to your GoPay merchant account. It generates dynamic QRIS payloads and provides real-time transaction reconciliation through automated mutation scanning.
Create GoPay Payment
Initialize a GoPay transaction. The system will generate a dynamic QRIS string that you can render as a QR code in your own application.
POST/gopay/create
Request Body (JSON)
| Parameter | Type | Status | Description |
|---|---|---|---|
| secret_key | String | Required | Your API secret key for authentication. |
| amount | Number | Required | Transaction amount. Minimal: 100. |
| payer_email | String | Required | Customer email for notification purposes. |
| external_id | String | Optional | Reference ID from your internal system. |
Implementation Snippets
Shell / cURL
curl -X POST https://api.stspoint.id/gopay/create \ -H "Content-Type: application/json" \ -d '{ "secret_key": "STS-Key-XXXXXXXX", "amount": 50000, "payer_email": "customer@email.com", "description": "GoPay Order #101" }'
Success Response
Payment Created JSON
{
"success": true,
"data": {
"external_id": "GPY-1730-XXXX",
"qr_string": "00020101021226660011ID.CO.GOPAY.WWW...",
"amount": 50428,
"base_amount": 50000,
"random_code": 428,
"status": "PENDING",
"remaining_quota": 14999
}
}Verify Payment Status
Check the current state of a GoPay transaction. The system will perform a live reconciliation against your GoPay merchant settlement reports.
POST/gopay/status
Status Success JSON
{
"success": true,
"data": {
"external_id": "GPY-1730-XXXX",
"status": "PAID",
"amount": 50428,
"paid_at": "2024-10-24T08:45:12Z",
"remaining_quota": 14982
}
}API Quota Management
Both creation and status verification requests consume your service quota. Ensure your polling logic is optimized to avoid hitting rate limits.