rajaongkir

Getting Started 🚀

Introduction

Welcome to the Komerce Payment API — a simple, secure, and flexible payment solution that allows you to accept and manage transactions through Virtual Accounts (VA) and QRIS seamlessly.

This API is designed for developers and businesses that need to integrate payment capabilities directly into their applications or systems.

Whether you’re running an e-commerce platform, a digital service, or a mobile app, Komerce Payment provides a unified way to handle payments, confirmations, and settlements efficiently.


🌐 API Overview

The Komerce Payment API supports two main environments:

EnvironmentBase URLDescription
Sandbox
https://api-sandbox.collaborator.komerce.id/user
Used for development and testing with simulated transactions.
Production
https://api.collaborator.komerce.id/user
Live environment for real payment transactions.
 note

💡 The Sandbox environment behaves like a real payment flow but uses simulated payment actions (for example, clicking a “Simulate Payment” button on the sandbox payment page).


⚙️ Key Capabilities

  • Virtual Account (VA) Payments — Automatically generate and track payments using various bank VAs.
  • QRIS Payments — Accept QR-based payments from any QRIS-supported mobile banking or e-wallet.
  • Payment Callback — Get instant notifications via webhook when a transaction status changes.
  • Sandbox Mode — Safely test payment flows before going live.
  • Dashboard Integration — Manage and monitor transactions in one place.

🔐 Authentication

All API requests require a valid API Key, which can be generated from your Merchant Dashboard.

The API uses Bearer Token Authentication:

key: YOUR_API_KEY

⚠️ Keep your API keys secure and never expose them in public repositories or client-side code.


🧩 Available Payment Channels

ChannelDescription
VA – BCA, BNI, BRI, Mandiri, Permata, etc
Virtual Account payments across supported banks.
QRIS
Dynamic QR code generated per transaction for multi-platform payments.

🚀 Next Steps

Ready to start?

Continue to the Endpoint guide to learn how to create your first transaction and test it in sandbox mode.

Next →

Endpoint