---
title: "Create a payment request"
method: POST
path: "/v3/payment/payment-requests"
tags: ["Payment requests"]
---

# Create a payment request

`POST /v3/payment/payment-requests`

For eligible partners only. Otherwise, use payment link to create a payment.

## Request body

- object
  - `callback_url` string, url, required — The user will be redirected to this URL after the payment
  - `transactions` object[], required
    - `currency` string, required
    - `amount` number, float, required
    - `execution_date` string, date — Allows you to schedule payments for a specific date (up to 60 days in advance)
    - `beneficiary` object — By default, the trusted beneficiary configured in the dashboard will be used Please contact us if you need to specify beneficiaries via the API
      - `first_name` string — Mandatory with lastname or only company_name (max 35 char : alphanumeric, space and some symbols + ( ) / . - ! ? , ; & % € are supported but it must contain at least one letter)
      - `last_name` string — Mandatory with firstname or only company_name (max 35 char : alphanumeric, space and some symbols + ( ) / . - ! ? , ; & % € are supported but it must contain at least one letter)
      - `company_name` string — Mandatory or firstname and last_name must be completed (max 35 char : alphanumeric, space and some symbols + ( ) / . - ! ? , ; & % € are supported but it must contain at least one letter)
      - `email` string — Mandatory depending on your use case
      - `iban` string
    - `client_reference` ClientReference — unresolved $ref
    - `end_to_end_id` EndToEndId — unresolved $ref
  - `user` object, required
    - `first_name` string — Mandatory with lastname or only company_name (max 35 char : alphanumeric, space and some symbols + ( ) / . - ! ? , ; & % € are supported but it must contain at least one letter)
    - `last_name` string — Mandatory with firstname or only company_name (max 35 char : alphanumeric, space and some symbols + ( ) / . - ! ? , ; & % € are supported but it must contain at least one letter)
    - `company_name` string — Mandatory or firstname and last_name must be completed (max 35 char : alphanumeric, space and some symbols + ( ) / . - ! ? , ; & % € are supported but it must contain at least one letter)
    - `email` string — Mandatory depending on your use case
    - `external_reference` ExternalReference — unresolved $ref
  - `provider_id` number, required — The unique identifier of the user's provider
  - `sender_iban` string — The IBAN which will be debited for providers that support it, otherwise this setting will be ignored

## Response `200`

Payment request creation response

- object
  - `id` string — The created payment request's unique identifier
  - `url` string — The url to go to initiate the payment

---

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