---
title: "Create Charge"
method: POST
path: "/transfer/open/institution/v1/pay/charge"
---

# Create Charge

`POST /transfer/open/institution/v1/pay/charge`

Initiate an account-to-account charge. `X-GatePay-On-Behalf-Of` specifies the initiating account ID for this transaction, and `accountId` specifies the payer account ID (the debited account). In the current version, this is a synchronous API and returns the final execution result directly.

## Headers

- `X-GatePay-Certificate-ClientId` string, required
- `X-GatePay-Timestamp` string, required
- `X-GatePay-Nonce` string, required
- `X-GatePay-Signature` string, required
- `X-GatePay-On-Behalf-Of` string, required

## Request body

- ChargeRequest
  - `merchantBatchNo` string, required — Unique batch ID from the merchant.
  - `accountId` string, required — Payer account ID.
  - `currency` string, required — Transfer currency.
  - `amount` string, required — Transfer amount.

## Response `200`

Success

- ChargeResponseWrapper
  - `status` string
  - `code` string
  - `errorMessage` string
  - `data` ChargeResponse — Charge execution result.
    - `merchantBatchNo` string — Batch ID; same as request merchantBatchNo.
    - `status` string — Status: PENDING (pending payment), PROCESS (processing), ERROR (failed), EXPIRED (expired), PAID (successful), CANCELLED (cancelled).
    - `toAccountId` string — Recipient account ID.
    - `fromAccountId` string — Payer account ID.
    - `createTime` integer — Order creation time, milliseconds.
    - `currency` string — Currency.
    - `amount` string — Transfer amount.

---

[API](https://skmtc.net/gate/apis/gatepay-institutional-api.md) · [All operations](https://skmtc.net/gate/apis/gatepay-institutional-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gate/gatepay-institutional-api/versions/bb3314b74dc3/schema)