Endpoint ⚙️

🧱 Base URL

All requests are made through the following base URLs:

Environment	Base URL
Sandbox	https://api-sandbox.collaborator.komerce.id/user
Production	https://api.collaborator.komerce.id/user

💡 Use the Sandbox environment for testing purposes before switching to Production.

🔑 Authorization

Every request to the Payment API must include an API Key for authentication.

You can find your API Key in the Merchant Dashboard after registration.

Example Header:

-H "x-api-key: YOUR_API_KEY"
-H "Content-Type: application/json"

⚠️ Never expose your API key in client-side code or public repositories.

⚙️ Core Endpoints

Here are the main endpoints to get you started:

Endpoint	Method	Description
`/methods`	GET	Retrieve payment methods and Banks Code
`/create`	POST	Create a new payment transaction
`/status/{id}`	GET	Retrieve payment status by transaction ID
`/callback`	POST	Receive payment notifications from the gateway
`/cancel`	POST	Cancel a VA payment

🚀 Create Your First Transaction

Here’s an example of how to create a new transaction:

curl --location 'https://api-sandbox.collaborator.komerce.id/user/api/v1/user/payment/create' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"order_id": (required),
"payment_type": "bank_transfer",
"channel_code": string (required, valid bank code),
"amount": integer (required, min 10.000),
"customer": {
"name": string (required),
"email": string (required, valid email),
"phone": string (required)
},
"items": [
{
  "name": string (required),
  "quantity": integer (required),
  "price": integer (required)
}
],
"expiry_duration": integer (optional, minimal 3600 seconds),
"callback_url": string (optional, valid URL),
"callback_api_key": (required if callback_url is filled, generate by user)
}'