# Payout request

Endpoint: POST /payout
Version: 1.2
Security: X-Api-Key

## Header parameters:

  - `X-Idempotency-Key` (string)
    The system supports the query deduplication mechanism. 
Any system-wide merchant's request after the first one with 
the same X-Idempotency-Key will return an error.
For example, if you have retrying mechanism for payouts and you want 
to avoid double sending, you can put header with value payout_{your_payout_id}

## Request fields (application/json):

  - `payment_method` (string, required)
    Enum: "CARD", "CRYPTO", "SEPA", "PAXUM", "BANK_TRANSFER"

  - `merchant_payment_id` (string, required)
    Field, might be uniq for every request (deduplication check)

  - `merchant_customer_id` (string, required)

  - `amount` (string, required)

  - `currency_code` (string, required)
    Currency code (ISO 4217), KRW for BANK_TRANSFER method

  - `payment_details` (any, required)

  - `description` (string)
    Description (Required field for BANK_TRANSFER payout type)

## Response 200 fields (application/json):

  - `type` (string, required)
    Enum: "PAYMENT"

  - `data` (object, required)

  - `data.payment_id` (string, required)

  - `data.payment_type` (string, required)
    Enum: "PAYOUT"

  - `data.created_at` (string, required)
    UTC date time format
    Example: "2020-20-20T20:00:00.633Z"

  - `data.merchant_id` (string, required)

  - `data.base_amount` (string, required)

  - `data.base_currency_code` (string, required)
    Currency code (ISO 4217)

  - `data.payment_method` (string, required)
    Enum: "CARD", "CRYPTO", "SEPA", "PAXUM", "BANK_TRANSFER"

  - `data.merchant_payment_id` (string, required)
    Field, might be uniq for every request (deduplication check)

  - `data.merchant_customer_id` (string, required)

  - `data.amount` (string, required)

  - `data.currency_code` (string, required)
    Currency code (ISO 4217), KRW for BANK_TRANSFER method

  - `data.payment_details` (any, required)

  - `data.description` (string)
    Description (Required field for BANK_TRANSFER payout type)

## Response 400 fields (application/json):

  - `errors` (array)

  - `errors.error_code` (string, required)
    Enum: "INVALID_REQUEST_PARAMETER", "INVALID_REQUEST", "INTERNAL_ERROR", "TOO_MANY_REQUESTS", "NOT_FOUND"

  - `errors.error_message` (string, required)

## Response 401 fields (application/json):

  - `errors` (array)

  - `errors.error_code` (string, required)
    Enum: "INVALID_REQUEST_PARAMETER", "INVALID_REQUEST", "INTERNAL_ERROR", "TOO_MANY_REQUESTS", "NOT_FOUND"

  - `errors.error_message` (string, required)

## Response 500 fields (application/json):

  - `errors` (array)

  - `errors.error_code` (string, required)
    Enum: "INVALID_REQUEST_PARAMETER", "INVALID_REQUEST", "INTERNAL_ERROR", "TOO_MANY_REQUESTS", "NOT_FOUND"

  - `errors.error_message` (string, required)