Create SWIFT payment

Create Swift payment

curl --request POST \
  --url https://api.pgw-sandbox.finventi.com/v2/transactions/swift \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "amount": 1050299,
  "charges": {
    "agentBic": "CHRGBICXXXX",
    "amount": 2550,
    "bearer": "DEBT",
    "currency": "EUR"
  },
  "clearingChannel": "RTGS",
  "creditor": {
    "agentBic": "INVELT2XXXX",
    "iban": "DE89370400440532013000",
    "name": "Creditor Company Incorporated"
  },
  "currency": "EUR",
  "debtor": {
    "agentBic": "MLLKMTM2XXX",
    "iban": "LT121000011101001000",
    "name": "Debtor Company Limited"
  },
  "endToEndId": "TXN123456789012345",
  "instructionId": "INSTR001234567",
  "messageRouting": {
    "receiverBic": "DEUTDEFFXXX"
  },
  "priority": "HIGH",
  "remittance": "Payment for invoice #INV-2025-001234",
  "serviceLevel": "URGP",
  "settlement": {
    "date": "2025-07-04",
    "iban": "GB29NWBK60161331926819",
    "method": "INDA"
  }
}
'

{
  "amount": 123,
  "createdAt": "2023-11-07T05:31:56Z",
  "creditor": {
    "agentBic": "<string>",
    "iban": "<string>",
    "name": "<string>"
  },
  "currency": "<string>",
  "debtor": {
    "agentBic": "<string>",
    "iban": "<string>",
    "name": "<string>"
  },
  "endToEndId": "<string>",
  "method": "SEPA",
  "settlementDate": "2023-12-25",
  "status": "<string>",
  "transactionId": 123,
  "remittance": "<string>"
}

POST

transactions

swift

Create Swift payment

curl --request POST \
  --url https://api.pgw-sandbox.finventi.com/v2/transactions/swift \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "amount": 1050299,
  "charges": {
    "agentBic": "CHRGBICXXXX",
    "amount": 2550,
    "bearer": "DEBT",
    "currency": "EUR"
  },
  "clearingChannel": "RTGS",
  "creditor": {
    "agentBic": "INVELT2XXXX",
    "iban": "DE89370400440532013000",
    "name": "Creditor Company Incorporated"
  },
  "currency": "EUR",
  "debtor": {
    "agentBic": "MLLKMTM2XXX",
    "iban": "LT121000011101001000",
    "name": "Debtor Company Limited"
  },
  "endToEndId": "TXN123456789012345",
  "instructionId": "INSTR001234567",
  "messageRouting": {
    "receiverBic": "DEUTDEFFXXX"
  },
  "priority": "HIGH",
  "remittance": "Payment for invoice #INV-2025-001234",
  "serviceLevel": "URGP",
  "settlement": {
    "date": "2025-07-04",
    "iban": "GB29NWBK60161331926819",
    "method": "INDA"
  }
}
'

{
  "amount": 123,
  "createdAt": "2023-11-07T05:31:56Z",
  "creditor": {
    "agentBic": "<string>",
    "iban": "<string>",
    "name": "<string>"
  },
  "currency": "<string>",
  "debtor": {
    "agentBic": "<string>",
    "iban": "<string>",
    "name": "<string>"
  },
  "endToEndId": "<string>",
  "method": "SEPA",
  "settlementDate": "2023-12-25",
  "status": "<string>",
  "transactionId": 123,
  "remittance": "<string>"
}

Overview

This endpoint creates SWIFT payments for international wire transfers. The payment is validated and submitted to the correspondent banking network.

Idempotent Endpoint

This endpoint supports idempotency to prevent duplicate transactions.

How to Use

Include an Idempotency-Key header with a unique value (UUID recommended)
The API returns the existing transaction when you reuse the same key
Retry requests safely without creating duplicates

Key Features

Supports multiple currencies
Handles correspondent bank routing
Validates BIC codes and account formats
Provides transaction tracking

Headers

Idempotency-Key

string

required

Unique identifier in scope of payment creation endpoints required to prevent unintended duplicate payments

Body

application/json

SWIFT payment request for creating cross-border payments

amount

integer

required

Transaction amount in cents

Example:

10102

creditor

object

required

Creditor information

Show child attributes

creditor.agentBic

string

required

Creditor agent (bank) BIC

creditor.name

string

required

Creditor name

Required string length: 1 - 140

creditor.iban

string

Creditor IBAN

creditor.otherAccount

object

Other account identification

Show child attributes

creditor.otherAccount.id

string

required

Account identifier

Required string length: 1 - 34

creditor.otherAccount.issuer

string

Issuer of the account identification

Required string length: 1 - 35

creditor.otherAccount.scheme

string

Scheme name code (e.g., BBAN)

Required string length: 1 - 35

currency

string

required

Currency code - must be from supported currencies per tenant

debtor

object

required

Debtor information

Show child attributes

debtor.agentBic

string

required

Debtor agent (bank) BIC

debtor.name

string

required

Debtor name

Required string length: 1 - 140

debtor.validAccountIdentification

boolean

required

debtor.iban

string

Debtor IBAN

debtor.otherAccount

object

Other account identification

Show child attributes

debtor.otherAccount.id

string

required

Account identifier

Required string length: 1 - 34

debtor.otherAccount.issuer

string

Issuer of the account identification

Required string length: 1 - 35

debtor.otherAccount.scheme

string

Scheme name code (e.g., BBAN)

Required string length: 1 - 35

settlement

object

required

Settlement information

Show child attributes

settlement.date

string<date>

required

Settlement date - will be recalculated according to SWIFT algorithm

settlement.method

enum<string>

default:INDA

required

Settlement method: COVE (cover), INDA (instructed agent). Defaults to INDA if not provided

Available options:

COVE,

INDA,

INGA

settlement.iban

string

Settlement account IBAN

settlement.otherId

string

Other account identifier

Required string length: 1 - 34

settlement.otherIssuer

string

Other account issuer

Required string length: 1 - 35

settlement.otherScheme

string

Other account scheme name code (e.g., BBAN)

Required string length: 1 - 35

charges

object

Charge information

Show child attributes

charges.agentBic

string

Charge agent BIC (required if charges are provided)

charges.agentClearingCode

string

Clearing system code for charge agent (optional)

Required string length: 1 - 35

charges.agentMemberId

string

Clearing system member ID for charge agent (optional)

Required string length: 1 - 35

charges.amount

integer<int64>

Charge amount in cents

Example:

101

charges.bearer

enum<string>

default:SHAR

Charge bearer: DEBT, CRED (mandatory if charges present), SHAR (default). If charge amount is provided, must be CRED or DEBT

Available options:

CRED,

DEBT,

SHAR,

SLEV

charges.currency

string

Charge currency code (required if charge amount is provided)

clearingChannel

enum<string>

Clearing channel: BOOK (book transfer), MPNS (mass payment net system), RTGS (real-time gross settlement), RTNS (real-time net settlement) (optional)

Available options:

BOOK,

MPNS,

RTGS,

RTNS

endToEndId

string

End-to-end identification assigned by the initiating party (optional, defaults to NOTPROVIDED if not provided)

Required string length: 1 - 35

instructionId

string

Instruction ID assigned by the instructing party (optional, uses transaction.id if not provided)

Required string length: 1 - 16

messageRouting

object

Message routing information - identifies the sender and receiver institutions

Show child attributes

messageRouting.receiverBic

string

Receiver's BIC code (To institution) - optional, calculated from tenant config if not provided

priority

enum<string>

Instruction priority: NORM (normal), HIGH (high) (optional)

Available options:

NORM,

HIGH

remittance

string

Unstructured remittance information (payment details)

Maximum string length: 140

serviceLevel

enum<string>

Service level code: BKTR (book transfer), NUGP (non-urgent priority), NURG (non-urgent), SDVA (same day value), URGP (urgent payment), URNS (urgent net settlement) (optional)

Available options:

BKTR,

NUGP,

NURG,

SDVA,

URGP,

URNS

Response

A new SWIFT payment has been created

SWIFT payment creation response

amount

integer

required

Transaction amount in cents

createdAt

string<date-time>

required

Transaction creation timestamp

creditor

object

required

Creditor response

Show child attributes

creditor.agentBic

string

required

Creditor agent BIC

creditor.iban

string

required

Creditor IBAN

creditor.name

string

required

Creditor name

currency

string

required

Currency code

debtor

object

required

Debtor response

Show child attributes

debtor.agentBic

string

required

Debtor agent BIC

debtor.iban

string

required

Debtor IBAN

debtor.name

string

required

Debtor name

endToEndId

string

required

End-to-end identification

method

enum<string>

required

Transaction method (always SWIFT)

Available options:

SEPA,

INST,

SDD,

SWIFT

settlementDate

string<date>

required

Settlement date

status

string

required

Transaction status

transactionId

integer<int64>

required

Unique transaction identifier

remittance

string

Remittance information

Reverse SDD Payment Transactions list

⌘I

Getting Started

Account Management

SEPA Instant

SEPA Direct Debit

SWIFT Payments

Payment Information

Nostro Accounts

Bank Information

Webhooks

Overview

Idempotent Endpoint

How to Use

Key Features

Headers

Body

Response

Getting Started

Account Management

SEPA Instant

SEPA Direct Debit

SWIFT Payments

Payment Information

Nostro Accounts

Bank Information

Webhooks

​Overview

​Idempotent Endpoint

​How to Use

​Key Features

Headers

Body

Response

Overview

Idempotent Endpoint

How to Use

Key Features