---
title: "Submit Payout Documents"
method: POST
path: "/v1/instances/{instance_id}/payouts/{id}/documents"
tags: ["Payouts"]
---

# Submit Payout Documents

`POST /v1/instances/{instance_id}/payouts/{id}/documents`

Submit compliance documents for SWIFT payouts requiring review. Includes optional payment description.

## Path parameters

- `instance_id` string, required
- `id` string, required

## Headers

- `Idempotency-Key` string — Optional key to safely retry this request without performing the action twice. Retrying with the same key and an identical body replays the original response; reusing a key with a different body returns an error. Keys are kept for 24 hours.

## Request body

- SubmitPayoutDocumentsIn
  - `transaction_document_type` 'invoice' | 'purchase_order' | 'delivery_slip' | 'contract' | 'customs_declaration' | 'bill_of_lading' | 'others', required — Document type
  - `transaction_document_id` string, required — Document identifier (invoice number, contract ID, etc.)
  - `transaction_document_file` string, uri, required — URL to the uploaded document
  - `description` string — Optional payment description/memo (max 128 chars)

## Response `200`

Documents submitted successfully

- Success
  - `success` boolean, required

## Other responses

- `400` — Possible error codes: `CUSTOMERS_NAME_INVALID`, `FILES_UNREADABLE`, `PAYOUTS_DOCUMENTS_NOT_ACCEPTED`, `VALIDATION_FAILED`, `VIRTUAL_ACCOUNTS_PARTNER_NOT_ELIGIBLE`. See the Error responses section for retry semantics.
- `401` — Possible error codes: `AUTH_UNAUTHORIZED`. See the Error responses section for retry semantics.
- `403` — Possible error codes: `AUTH_FORBIDDEN`. See the Error responses section for retry semantics.
- `404` — Possible error codes: `PAYOUTS_NOT_FOUND`. See the Error responses section for retry semantics.
- `429` — Possible error codes: `AUTH_RATE_LIMITED`. See the Error responses section for retry semantics.
- `500` — Possible error codes: `FILES_UNREADABLE`, `INTERNAL_ERROR`. See the Error responses section for retry semantics.

---

[API](https://skmtc.dev/blindpay/apis/blindpay-api.md) · [All operations](https://skmtc.dev/blindpay/apis/blindpay-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/blindpay/blindpay-api/revisions/470de27afb7b/schema)