---
title: "Create Disbursement Link API"
method: POST
path: "/v1/transfer-links"
---

# Create Disbursement Link API

`POST /v1/transfer-links`

## Request

- Base URL: `https://api.sandbox.midtrans.com`
- URL: `https://api.sandbox.midtrans.com/v1/transfer-links`
- Auth: HTTP basic

## Headers

- `X-Request-Id` string
- `X-Idempotency-Key` string

## Request body

- object
  - `amount` integer, required: Net amount of the transaction. Currently supporting IDR.
  - `type` 'DISBURSEMENT', required: The type of disbursement link transaction. Currently supporting "DISBURSEMENT".
  - `remark` string, required: Remark / transaction description. Uniqueness is encouraged. It is restricted to a maximum of 50 characters.
  - `reference_no` string: Transaction number that you can customize or pre-generated for transfer link (only if transfer is present, currently supporting alphanumeric).
  - `beneficiary_name` string: Beneficiary Name can also be optional.
  - `beneficiary_email` string: Beneficiary Email is optional by default (only mandatory for password flow).
  - `title` string: Title of the Disbursement Link (by default "General Disbursement")
  - `expiry_date` string: Expiry date in RFC-3339 format.

## Response `200`

200

- object
  - `success` boolean
  - `errors` object[]
  - `data` object
    - `id` string
    - `disbursement_url` string

## Other responses

- `400`: 400
- `500`: 500

---

[API](https://skmtc.dev/midtrans/apis/coreapi.md) - [All operations](https://skmtc.dev/midtrans/apis/coreapi/llms.txt) - [OpenAPI document](https://skmtc.dev/midtrans/apis/coreapi/revisions/bbf7d11a1f1f?raw)