---
title: "Create payment service provider transactions"
method: POST
path: "/api/v1/paymentServiceProviders/{id}/transactions"
tags: ["Payment Service Provider"]
---

# Create payment service provider transactions

`POST /api/v1/paymentServiceProviders/{id}/transactions`

Creates one or more transactions for a specific payment service provider.

## Path parameters

- `id` string, required — Resource identifier.

## Request body

- object
  - `transactions` object[], required
    - `transaction` object, required
      - `id` string, required — Unique identifier of the transaction
      - `vendorKey` 'paypal' | 'mollie', required — Key identifying the payment service provider vendor
      - `parentId` string, nullable — Identifier of the parent transaction if this is a child transaction
      - `referenceNumber` string, nullable — Reference number associated with the transaction
      - `merchantId` string, nullable — Identifier of the merchant in the payment service provider's system
      - `type` string, required — Type of the transaction
      - `feeType` string, nullable — Type of fee associated with the transaction
      - `createdAt` string, date-time, required — Creation timestamp of the transaction
      - `updatedAt` string, date-time, required — Last update timestamp of the transaction
      - `status` string, required — Current status of the transaction
      - `amount` object, required
        - `amount` string, required — Transaction amount
        - `currency` string, required — Currency matches one of currency values as specified in ISO-4217.
      - `descriptiveText` string, required — Human-readable description of the transaction
      - `feeAmount` object, nullable
        - `amount` string — Fee amount
        - `currency` string — Currency matches one of currency values as specified in ISO-4217.
      - `paymentMethodType` string, nullable — Type of payment method used for the transaction
      - `payoutId` string, nullable — Identifier of the associated payout
      - `payerInfo` object, nullable
        - `accountId` string, nullable — Identifier of the payer's account
        - `email` string, nullable — Email address of the payer
        - `firstName` string, nullable — First name of the payer
        - `lastName` string, nullable — Last name of the payer
        - `countryCode` string, nullable — Country code of the payer's location
      - `shippingInfo` object, nullable
        - `recipientName` string, nullable — Name of the shipping recipient
        - `addressLine1` string, nullable — First line of the shipping address
        - `addressLine2` string, nullable — Second line of the shipping address
        - `city` string, nullable — City of the shipping address
        - `zipCode` string, nullable — Postal code of the shipping address
        - `countryCode` string, nullable — Country code of the shipping address
      - `bankView` object, nullable
        - `iban` string, nullable — International Bank Account Number
        - `accountNumber` string, nullable — Bank account number
        - `bic` string, nullable — Bank Identification Code (BIC)
        - `bankName` string, nullable — Name of the bank

## Response `201`

Transactions created successfully

## Other responses

- `400` — IETF RFC 9457 Problem API compliant response
- `401` — Unable to authenticate the client
- `403` — Unable to authorize the client
- `415` — Resource representation send in the request is not supported.
- `429` — Too many API calls made.

---

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