Merchant Virtual Accounts

Overview

TemboPlus offers a Merchant Virtual Account API that enables merchants to establish dedicated payment collection channels. Through this API, merchants can create virtual accounts linked to their business.

Each merchant virtual account functions as a payment destination that merchants can share with their customers. When funds are deposited into this merchant virtual account, TemboPlus automatically notifies the merchant via a webhook callback to their configured URL, enabling real-time payment processing.

The API also provides endpoints that allow merchants to check account balances and retrieve transaction statements, giving them complete visibility into their payment collection activities.

Common Headers

All API requests require the following headers:

Header	Required	Description
Content-Type	Yes	Must be set to application/json for all requests
Authorization	Yes	Authentication token in the format: Bearer <token>. This token will be provided to you during the onboarding process.
x-request-id	Yes	A UUID that uniquely identifies each request. Must be different for each API call. Used for request tracking and troubleshooting. If you encounter any issues, please include this ID when contacting support.

Available Endpoints

The API provides the following key endpoints:

1. Create Merchant Virtual Account - Create a new virtual account for payment collection

2. Get Merchant Virtual Account Statement - Retrieve transaction history for a specific period

3. Get Merchant Virtual Account Balance - Check the current balance of a virtual account

Transaction Callback Service

When a transaction occurs in your merchant virtual account, TemboPlus will notify you via a webhook callback to your configured URL. This enables real-time payment processing and instant notification of new transactions.

For detailed information about the callback service, including request structure, payload details, and security verification, please refer to the Transaction Callback Service documentation.