Developer Documentation

Complete API documentation, SDKs and integration guides to help you quickly integrate OTGPAY payment system

Quick Integration

Clear process guidance from application to go-live operations

1

Apply for Integration

Submit your basic information and business needs

2

Get Credentials

Get API Key and merchant ID

3

Test Integration

Complete technical integration in test environment

4

Go Live

Deploy to production after approval

Country-Specific Integration Documentation

Select your target country to get detailed integration guides and local payment method explanations

logo

Indonesia

Local payment method integration guide, covering mainstream payment methods, high success rate integration

View Integration Documentation
logo

Thailand

Bank transfer and e-wallet integration guide, real-time arrival confirmation mechanism

View Integration Documentation
logo

Pakistan

Local transfer channel integration, large-amount volume business integration solution

View Integration Documentation

API Interface Documentation

Support multiple interfaces for different business needs

logo

Payment Interface

  • POST /api/payment/create - Create payment order
  • GET /api/payment/{id} - Query payment status
  • POST /api/payment/{id}/refund - Initiate refund
logo

Payout Interface

  • POST /api/payout/submit - Submit payout request
  • GET /api/payout/{id} - Query payout status
  • POST /api/payout/batch - Batch payout
logo

Query Interface

  • GET /api/settlement/records - Get settlement records
  • GET /api/statement - Get statement
  • GET /api/balance - Get account balance

Code Examples

Quick start code snippets

JavaScript

//request
{
    "appId": 1054,
    "orderId": "M233323000059",
    "amount": "300",
    "phone": "08230219312",
    "email": "23423@qq.com",
    "name": "test",
    "inBankCode": "014",
    "payType": "QR",
    "sign": "af0gAHkUOyYHu9owQp8NJ4mPEeUW4vuJcjdxqLIzrVw8AvpLSjD1DXupReSG/CyuSkFRyiIvCp5u703AuGGmfgD2gKDH3Ywau41bAbG2jnHJ8mtjiSJ5iWUzanyd4Kr7d1+rETbzUl7/BkW3t0X8UUFdqpxwG8DPUjAwUKfplWDHV7koG51Ozexd80DCsmW6eWdouAZ1uNXGLYmV3ftE3BmfNRtuv1C5bfTJWrTEIOxbF6g2uYOFZTlIgrQgd7/2PsAYwQQXNz8Q8CYl4OxqCv4pXJxaLWPbR5tqZu9og5kn32C9aHW/NlU1y39vzz+4ef81yPAqUV9oHlSMSPrMmw=="
}

//response
{
    "status": "1",
    "error": "00000000",
    "msg": "",
    "data": {
        "orderId": "M233323000059",
        "orderNo": "6023071013539074",
        "payUrl": "https://a.api-uat.idr.com/1L9zQS2",
        "bankCode": "014",
        "qrCode": "00020101021228760011ph.ppmi.p2m0111OPDVPHM1XXX0315777148000000017041652948137245442930503001520460165303608540810000.vnd Of Mandalu62310010ph.allbank05062110000803***88310012ph.ppmi.qrph0111OPDVPHM1XXX63042763",
        "sign": "YEoA8Y2JzQFGVzwJSqmemm1Kfv/bfyIfCqv2dp7RNzT5B72AQvdD+nt2nR4sL1HWscvmNHyVt5ovAi7MMhy3ziih/sMph+wPx4YjH3W1h5DyBvSlWvaKfKrK5ViomZ0pPYWydwRHnnRnicxToHK9S6qtSy7Q73O0hdz4hJ9p41Th3ycBl2Q9SeqSZYSY1ohcPDhdyRf2y0prb8rHgpBKzxZ5BKX/1bsE9OmsSEHAEYT8OGgko6aNe8XPAhr4G48cpWTftvnGQuzh0O65nuZRI/PF+Axt2zJCVbFHDDSREI9NlAT82ebDqhlVdxQzKE67D1nxgjb3dPmDUYHOBpmwxQ=="
    }
}

Security & Callbacks

Learn how to securely handle callbacks and signature verification

logo

Signature Verification

All callback requests include digital signatures to ensure data integrity and authenticity

  • 1. Get callback data and signature
  • 2. Recalculate signature using your secret key
  • 3. Compare signatures for match
logo

Webhook Callbacks

System triggers callbacks when critical events like payment, payout occur

  • payment.completed - Payment completed
  • payment.failed - Payment failed
  • payout.completed - Payout completed
  • payout.failed - Payout failed

Error Codes

Common error codes and solutions

1001

param is null

Parameters are empty. Please check whether the parameters are correct

1002

Illegal Param

VInvalid parameters. Please check whether the parameters are correct

1003

system exception

System error

1004

system is busy

The system is busy

4013

order not exit

Order not found

4014

order is already end status

The order is in a final state

Ready to partner with us ?

Contact our team to discuss your payment needs and cooperation plan

Contact Us