---
title: "Create merchant batch transfer"
method: POST
path: "/v1/pay/batch/transfer"
tags: ["reward-distribution"]
---

# Create merchant batch transfer

`POST /v1/pay/batch/transfer`

Create a batch transfer order from a merchant to multiple users.

## Headers

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

## Request body

- RewardDistributionCreateRequest — Request body for creating a merchant batch transfer order.
  - `batchId` string, required — Internal batch correlation ID used to associate the batch record with its sub-orders. Keep it unique within the merchant account. It may use the same value as `merchant_batch_no`.
  - `bizscene` 'DIRECT_TRANSFER', required — Business scenario identifier. This endpoint currently supports only `DIRECT_TRANSFER`.
  - `merchant_batch_no` string, required — Merchant-side business batch number used for request idempotency and merchant queries. It must be unique on the merchant side.
  - `name` string — Display name of the batch transfer.
  - `description` string — Description of the batch transfer.
  - `batchorderList` RewardDistributionOrderItem[], required — List of transfer sub-orders.
    - `user_id` integer, required — Receiver user ID.
    - `amount` string, required — Transfer amount.
    - `currency` string, required — Currency of the sub-order. The sub-order currency must match the main order currency.
    - `rewardId` string, required — Merchant-generated unique sub-order ID. Only letters (A-Z, a-z), digits, and underscores are allowed. Maximum length: 32 characters.
  - `channelId` string — Channel ID, optional.
  - `is_coupon` boolean — Whether this is a coupon scenario. Optional, default is false.

## Response `200`

Batch transfer creation result

- RewardDistributionCreateResponse — Response body for creating a merchant batch transfer order.
  - `status` string, required — API response result, SUCCESS or FAIL.
  - `code` string, required — Response error code.
  - `errorMessage` string — Error description.
  - `data` RewardDistributionCreateResult
    - `merchant_batch_no` string — Merchant batch number.
    - `batch_id` string — Internal batch correlation ID provided in the request.

---

[API](https://skmtc.net/gate/apis/gatepay-withdrawal-wallet-api.md) · [All operations](https://skmtc.net/gate/apis/gatepay-withdrawal-wallet-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gate/gatepay-withdrawal-wallet-api/revisions/2c8a39daf986/schema)