# Create payment instruction

Creates a new payment instruction of the specified type (for example autogiro) for the client identified by client_id.
Provide an array of payments with details such as amount, destination account, and a unique clientRef.
The response returns the instruction id, the list of created payments, a bankTransferRef if available, and the initial status (for example new) so you can track subsequent processing and settlements.

Endpoint: POST /v2/partner/client/{client_id}/instruction/payment
Version: 2.0.0
Security: oAuth

## Path parameters:

  - `client_id` (string, required)
    The ID of requested client.
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

## Request fields (application/json):

  - `type` (any)
    The type of payment
    Enum: "autogiro"

  - `payments` (array)
    Array of payment instructions

  - `payments.amount` (number, required)
    The amount of the payment
    Example: 110

  - `payments.clientRef` (string, required)
    Client specified reference for keeping track of payment.
Value is copied to the clientRef of transactions
    Example: "instruction_id_29384"

## Response 200 fields (application/json):

  - `id` (string)
    UUID (Universally Unique Identifier)
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

  - `type` (string)
    The type of instruction
    Example: "autogiro"

  - `instructions` (array)
    Array of payment instructions

  - `instructions.amount` (number, required)
    The amount of the payment
    Example: 110

  - `instructions.account` (string, required)
    UUID (Universally Unique Identifier)
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

  - `instructions.clientRef` (string, required)
    Client specified reference for keeping track of payment.
Value is copied to the clientRef of transactions

  - `bankTransferRef` (string,null)
    The text to use in a bank transfer. Not applicable for autogiro
    Example: "REF-12345"

  - `status` (string)
    instruction status

## Response 400 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "invalid_request"

  - `error_description` (string)
    Description of error

## Response 401 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "unauthorized"

  - `error_description` (string)
    Description of error

## Response 403 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "forbidden"

  - `error_description` (string)
    Description of error

## Response 500 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "server_error"

  - `error_description` (string)
    Description of error

## Response 503 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "service_unavailable"

  - `error_description` (string)
    Description of error