API Documentation

Integrate ArusPay into your applications

Getting Started

Authentication

All API requests require authentication using your API key

Get your API key from the Settings page after logging in.

Use Live API Key (Production) for this environment

Include your API key in the header:

Authorization: Bearer YOUR_API_KEY

Base URL:

https://aruspay.my.id/api/v1

API Endpoints

POST/payments/create

Create a payment request with QR code

Request Body:

{
  "order_id": "ORDER-12345",
  "amount": 50.00,
  "description": "Product purchase",
  "callback_url": "https://yoursite.com/callback",
  "redirect_url": "https://yoursite.com/success"
}

cURL Example:

curl -X POST "https://aruspay.my.id/api/v1/payments/create" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "order_id": "ORDER-12345",
    "amount": 50.00,
    "description": "Product purchase"
  }'

Response:

{
  "success": true,
  "data": {
    "payment": {
      "reference": "PAY-A1B2C3D4E5F6",
      "amount": 50.00,
      "status": "pending"
    },
    "payment_url": "https://aruspay.my.id/pay/PAY-...",
    "qr_code_url": "data:image/png;base64,..."
  }
}

GET/payments/status

Check payment status

Query Parameters:

reference - Payment reference (required)

cURL Example:

curl -X GET "https://aruspay.my.id/api/v1/payments/status?reference=PAY-xxx" \
  -H "Authorization: Bearer YOUR_API_KEY"

Error Codes

Code	Status	Description
`400`	Bad Request	Invalid parameters
`401`	Unauthorized	Invalid API key
`403`	Forbidden	Insufficient permissions
`404`	Not Found	Resource not found
`422`	Unprocessable	Validation error
`429`	Rate Limited	100 req/min limit
`500`	Server Error	Internal error

Webhooks

Event Notifications

Receive real-time notifications when events occur

Configure your webhook URL in Settings. We'll send POST requests when events occur.

Available Events:

transaction.completed

transaction.failed

transfer.received

withdrawal.approved

withdrawal.rejected

Webhook Payload:

{
  "event": "transaction.completed",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "transaction_id": "txn_abc123",
    "type": "top_up",
    "amount": 100.00,
    "status": "completed"
  }
}

SDKs & Libraries

JavaScript / Node.js

npm install @aruspay/sdk

Coming Soon

Python

pip install aruspay

Coming Soon

PHP

composer require aruspay/sdk

Coming Soon

Ready to Integrate?

Create an account to get your API keys