---
title: "Create out payment"
method: POST
path: "/out_payment"
tags: ["Out Payment"]
---

# Create out payment

`POST /out_payment`

Get your strong authentication RSA private key from Easypay Backoffice on menu:</br>Web Services->Configuration API 2.0->Keys.

**Required scope:** <code style="background:#e8f0fe;color:#1a73e8;padding:2px 8px;border-radius:12px;font-size:0.85em">out_payment:create</code>

## Request body

- object
  - `customer` Customer, required — The Customer object contains the necessary details about the customer involved in the transaction. This includes identification information, contact details, and preferences. All fields are optional unless specified otherwise.
    - `id` string, uuid — Unique identifier for the customer. When provided, it links the transaction to an existing customer record.
    - `name` string — Full name of the customer. This is typically displayed on receipts and statements.
    - `email` string, email — Customer's email address. Used for sending receipts, notifications, and payment confirmations.
    - `phone` string — The contact phone number of the customer, excluding the country code indicator (e.g., "+351"). This field is used for communication purposes. If the payment method is MB WAY, the phone_number is required and is used to send the MB WAY push notification.
    - `phone_indicative` string — The country code indicator for the customer's phone number (e.g., "351" for Portugal). This field is used in conjunction with the phone number to ensure proper international dialing and communication.
    - `fiscal_number` string — Customer's tax identification number or fiscal number. Format may vary by country.
    - `key` string — A customizable text field for users to input their own identifier for the customer. This can be any string that helps the user uniquely identify the customer in their own system.
    - `language` 'PT' | 'EN' | 'ES' — Preferred language for customer communications. Uses ISO 639-1 language codes.
  - `key` string — Merchant identification key
  - `value` number, double, required — Value will be rounded to 2 decimals
  - `type` 'normal' | 'instant' — Optional - only applicable to method transfer
  - `schedule_at` string — Scheduled date and time to execute the payment, in `YYYY-MM-DD HH:MM` format (UTC, no timezone suffix).
  - `descriptive` string — Description for the out payment.
  - `account` Account
    - `id` string, uuid
  - `out_account` OutAccount, required
    - `account_holder` string, required — Bank account holder name
    - `iban` string, required — Only IBANS from SEPA zones are supported
    - `email` string, required
    - `phone` string, required
    - `key` string — Custom string controlled by our clients
    - `country_code` string — Bank account country code
  - `method` 'transfer' | 'mb', required
  - `timestamp` string, required — Unix timestamp UTC, must be no more than 1 minute before or after real time, if not the strong authentication signature will not be valid

## Response `201`

Created

- object
  - `status` string
  - `message` string[]
  - `id` string, uuid — A unique identifier for the resource. While typically formatted as a UUID (Universally Unique Identifier), it can also be in other formats as defined by the user. This field ensures the resource can be distinctly recognized and referenced.
  - `method` object
    - `type` 'normal' | 'instant'
    - `status` 'pending' | 'delayed' | 'success' | 'deleted'
  - `customer` object — Customer associated with the out payment.
    - `id` string, uuid — Unique identifier for the customer.
  - `out_account` object — Destination SEPA bank account for the out payment.
    - `id` string, uuid — Unique identifier for the destination account.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/easypay/apis/easypay-payments-api.md) · [All operations](https://skmtc.net/easypay/apis/easypay-payments-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/easypay/easypay-payments-api/versions/cdf25a9ad7b2/schema)