---
title: "Payment: Refund Request"
method: POST
path: "/payments/{id}/refund_request"
tags: ["Payments"]
---

# Payment: Refund Request

`POST /payments/{id}/refund_request`

A "Refund Request" requests that a payment be refunded manually. This can be used for payment methods that do
not support refunds, such as konbini. To support non-refundable payment methods, a bank account must be
specified so that we know where to send the funds. Since it is a manual process, the refund will be carried
out at a later date, and there's a possibility of it being rejected.

## Path parameters

- `id` string, required — A unique 25-character alphanumeric resource identifier.

## Request body

- CreateRefundRequestRequest
  - `amount` integer, required — The payment amount before tax, greater than or equal to 0, in the lowest denomination of the currency (e.g. cents for USD).
  - `customer_name` string, required — Customer's name in half-width katakana, as registered at the bank.
  - `bank_name` string, required — Name of the customer's bank.
  - `bank_code` string — Optional 4-digit Zengin bank code.
  - `branch_name` string — Name of the customer's bank branch.
  - `branch_number` string, required — 3-digit branch number.
  - `account_type` 'normal' | 'checking' | 'savings', required — Type of the customer's bank account.
  - `account_number` integer, required — 7-digit bank account number to deposit the refund into.
  - `include_payment_method_fee` boolean, required — Whether the refund should include the original payment method fee.
  - `description` string — Optional description or reason for this refund request.
  - `platform_details` PlatformDetails
    - `submerchants` Submerchant[], required — Array of submerchant split configurations for this platform payment.
      - `submerchant_id` string, required — A unique 25-character alphanumeric merchant identifier.
      - `amount` integer, required — The amount with tax included, greater than or equal to 0, in the lowest denomination of the currency (e.g. cents for USD).
      - `platform_fee` integer, required — The platform fee amount, tax included, greater than or equal to 0, in the lowest denomination of the currency (e.g. cents for USD).
    - `processing_merchant_id` string — A unique 25-character alphanumeric resource identifier.

## Other responses

- `403` — Invalid authorization
- `404` — Payment does not exist
- `503` — Maintenance

---

[API](https://skmtc.net/komoju/apis/komoju-api.md) · [All operations](https://skmtc.net/komoju/apis/komoju-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/komoju/komoju-api/revisions/65483c40ba32/schema)