Skip to main content
POST
/
v1
/
charges
Create a Charge
curl --request POST \
  --url https://api.example.com/v1/charges \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 5300,
  "currency": "IDR",
  "channel_code": "qr_qris",
  "reference_id": "merchant_26",
  "description": "Viridis cogo aureus. Tollo eum antepono administratio cupressus dolore uredo. Amissio decet vir subvenio asperiores. Degusto vesper aer.",
  "metadata": {
    "qui6": "culpa elit",
    "cillum9b": "amet in dolore",
    "dolor74": "deserunt reprehenderit magna do"
  }
}
'
{ "action": { "embedded_url": "https://checkout.monxa.dev/payments/019a058a-0a86-7c35-969e-f883a56f1e10", "simulation_url": "https://checkout.monxa.dev/payments/simulation/019a058a-0a86-7c35-969e-f883a56f1e10", "type": "PRESENT_TO_CUSTOMER" }, "meta_data": { "qui6": "culpa elit", "cillum9b": "amet in dolore", "dolor74": "deserunt reprehenderit magna do" }, "action_flow": "EMBEDDED", "amount": 4300, "channel_code": "QR_QRIS", "code": "CHG_2510969EF883A56F1E10", "currency": "IDR", "description": "Viridis cogo aureus. Tollo eum antepono administratio cupressus dolore uredo. Amissio decet vir subvenio asperiores. Degusto vesper aer.", "merchant_id": "019a0423-2941-735f-9a93-819df469ad39", "reference_id": "merchant_26", "status": "PENDING", "created_by": "drunk@sandbox.dev", "created_on": "2025-10-21T06:52:04.1021719+00:00", "updated_by": "drunk@sandbox.dev", "updated_on": "2025-10-21T06:52:04.365363+00:00", "id": "019a058a-0a86-7c35-969e-f883a56f1e10" }

Documentation Index

Fetch the complete documentation index at: https://docs.monxa.co/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
x-idempotency-key
string

Body

application/json
​
amount
number<double>
required

The amount to be charged, expressed in minor units (e.g., 10000 = 100.00).

​
currency
string
required

The three-letter ISO 4217 currency code (e.g., IDR, MYR, SGD).

​
channel_code
enum<string>
required

The payment channel to be used, such as qr_qris, bank_redirect_fpx, wallet_dana, etc.

Available options:
qr_qris
​
action_flow
enum<string>
required

The type of payment flow, e.g.redirect, or show. Determines how Merchant presents the payment experience to the user.

Available options:
payload,
redirection,
embedded
​
reference_id
string | null

Merchant’s unique reference ID for this charge (e.g., order number or invoice ID). Used for reconciliation and idempotency tracking.

​
description
string | null

Optional short text describing the purpose of the payment or charge. Useful for invoices or customer-facing receipts.

​
metadata
object

Optional custom key–value pairs for additional information

Response

OK

​
id
string
required

Unique identifier of the charge

​
code
string
required

nique charge code generated by Monxa for tracking or reconciliation. (e.g. chg_2510BBFC2A3A6CE22F1B).

​
reference_id
string
required

Merchant-provided identifier such as invoice or order number.

​
merchant_id
string
required

Unique ID of the merchant who created the charge.

​
amount
integer
required

Charge amount in minor units (e.g., 3500 = IDR 35.00).

​
currency
string
required

ISO 4217 currency code (e.g., IDR, MYR, SGD).

​
channel_code
string
required

The selected payment channel (e.g., qr_qris, bank_redirect_fpx, wallet_dana).

​
action_flow
string
required

Defines how the charge is presented — e.g., payload, redirection, or embedded.

​
status
string
required

Current charge status (PENDING, SUCCEEDED, FAILED, etc.).

​
description
string
required

Merchant’s description of the charge or transaction.

​
metadata
object
required

Custom key–value pairs provided in the request for additional context.

​
action
object
required

Contains payment instructions or URLs to be presented to the customer.

​
embedded_url
string
required
​
created_by
string
required

Identifier of the user or API key that created the charge.

​
created_on
string
required

Timestamp when the charge was created.

​
updated_by
string
required

Identifier of the user or process that last updated the charge.

​
updated_on
string
required

Timestamp of the last update to this charge.