# Import a batch of payment transactions settled outside the platform

**POST /2026-4/payment-transaction-imports**

Imports payment transactions that were settled outside the platform, so they appear in the transaction history next to platform transactions. The import never moves money: the records are stored as they are, as IMPORTED transactions that can neither be captured, cancelled nor documented. Every record is decided individually - imported, skipped because its external id was imported before, or failed with a reason - and `include=items` reports each result, so a partially failed batch is retried with the failed records only. A malformed record rejects the whole request instead.


## Servers
- PACE Payment Service: https://api.pace.cloud/payment (PACE Payment Service)


## Authentication methods
- Oauth2
- Oauth2


## Parameters


### Query parameters

- **include** (array[string])
  Related resources to include in the response.


### Body: application/json (object)

- **clientId** (string)
  The identifier of the client the imported transactions belong to. Required if not requesting with the :authenticated scope, which defaults it to the requesting client and allows no other.

- **transactions** (array[object])
  The transactions to import, at most 100 per request. Each `externalId` must be unique within the request. A single malformed entry rejects the whole request; larger backfills page through multiple requests.

- **userId** (string(uuid))
  The unique identifier of the user the imported transactions belong to. Required if not requesting with the :authenticated scope, which defaults it to the authenticated user and allows no other.



## Responses
### 201
The import was processed. Request `include=items` for the result of every record.

#### Body: application/json (object)
- **data** (object)
  The created import with the result of every submitted record.


### 400
The request body is invalid: a missing client or user, a malformed record, a duplicate external id, an empty or too large batch, an authorization after its capture, a timestamp in the future, invalid product configurations, or totals that do not match the products. Nothing was imported.

### 401
Client authentication failed.

### 403
The caller may only import its own transactions and named another client or another user.

Missing one or more required scopes.

### 500
An internal server error occurred.


[Powered by Bump.sh](https://bump.sh)