1. Transactions
Payswix | Agents API
  • Finance account
    • Getting started
    • Validation rules
    • Virtual IBANs
      • NACE codes
      • Create vIBAN for person or company
      • Get a list of vIBANs
    • Transactions
      • Create a SEPA transfer
      • Get transfer fee
      • Get all existing recipients
      • Get transaction information
      • Get a filtered list of transactions
    • Companies
      • Get specific company details
    • Accounts
      • Create a new account
      • Get all user accounts
      • Get user account information by account number
    • Other
      • Check if the server is alive
    • Webhooks
      • Transaction webhook
    • Schemas
      • Company vIBAN
      • Person vIBAN
      • Transaction
  • Standard account
    • Transactions
      • Create a SEPA transfer
        POST
      • Create a SWIFT transfer
        POST
    • Schemas
      • Transaction
  1. Transactions

Create a SWIFT transfer

POST
/agents/v1/transactions/{clientId}/transfers/swift
SWIFT transfers are not supported by Finance accounts, you can only make a SWIFT transfer from your Standard account.

Request

Authorization
API Key
Add parameter in header
X-API-KEY
Example:
X-API-KEY: ********************
or
Path Params

Body Params application/json

Examples

Responses

🟢200
application/json
Bodyapplication/json

🟠401
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://demo-api.payswix.com/agents/v1/transactions//transfers/swift' \
--header 'X-API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "fromAccount": "45857602986",
    "beneficiary": "Beneficiary of the SWIFT payment",
    "toAccount": "GB33BUKB20201555555555",
    "amount": 0.05,
    "currency": "GBP",
    "beneficiaryAddress": "Menulio 7",
    "beneficiaryCity": "Vilnius",
    "beneficiaryBankSwift": "BUKBGB22XXX",
    "beneficiaryCountryCode": "GB",
    "beneficiaryPostalCode": "04354",
    "details": "string"
}'
Response Response Example
200 - Success
{
    "is_success": true,
    "data": {
        "paymentMethod": null,
        "currencyType": 1,
        "referenceTransaction": null,
        "referencedBy": [],
        "parameters": [],
        "clientDeclineReason": null,
        "fromAccountIban": "LT173880005087983371",
        "beneficiaryAccountIban": "LT613880005539913436",
        "providerType": "internal",
        "isSelfTransfer": false,
        "isDynamicTransfer": false,
        "isScheduled": false,
        "transferMethod": null,
        "counterpartyId": "72e5fe0c-1688-484d-b7d5-6313dde60bf4",
        "id": "fcca0766-14a3-49ec-9433-97fe789e2575",
        "account": {
            "discriminator": 0,
            "clientType": 1,
            "clientName": "UAB Baltic Trading",
            "iban": "LT743880009208239802",
            "beneficiaryType": 2,
            "metadata": {
                "status_changed_by": {
                    "actor": "Jonas Jonaitis"
                }
            },
            "providerCurrency": "",
            "external": false,
            "dynamicPayment": false,
            "providerRequisites": {
                "": {
                    "bankCode": null,
                    "bankAccountNumber": "LT173880005087983371"
                }
            },
            "number": "59208239802",
            "type": 1,
            "cards": [],
            "status": 1,
            "primary": true,
            "name": "Primary account",
            "provider": {
                "cardIssuer": false,
                "name": "litas_sepa",
                "currency": null,
                "currencies": [],
                "externalId": null
            },
            "providerNumber": "LT743880009208239802",
            "createdAt": "2026-04-07T10:21:22+00:00",
            "dormant": false,
            "default_fee_activation_date": 0,
            "balances": [],
            "totalEquivalentBalance": null,
            "prohibitedOperations": []
        },
        "status": 0,
        "state": 0,
        "type": 4,
        "provider": "internal",
        "providerId": null,
        "providerEndToEndId": null,
        "remitterName": "UAB Example Logistics",
        "remitterAccountNumber": "59208239802",
        "beneficiaryType": 1,
        "remitterType": 2,
        "beneficiaryName": "David Miller",
        "beneficiaryAccountNumber": "75539913436",
        "amount": -10.3,
        "currency": "EUR",
        "description": "For payment of services",
        "bankDetails": {
            "purposeLabel": null,
            "categoryPurposeLabel": null,
            "beneficiaryName": "David Miller",
            "beneficiaryCode": null,
            "beneficiaryTaxCode": null,
            "beneficiaryAdditionalCode": null,
            "beneficiaryAddress": "Pavasario g 48",
            "beneficiaryCity": "Vilnius",
            "beneficiaryPostalCode": "10321",
            "beneficiaryState": null,
            "beneficiaryCountryCode": "LT",
            "remitterAddress": "Gedimino pr. 12-5",
            "remitterCity": "Vilnius",
            "remitterPostalCode": "01103",
            "remitterState": null,
            "remitterCountryCode": "LT",
            "bankName": "PAYSWIX, UAB",
            "bankCountryCode": "LT",
            "bankAddress": "LVIVO G. 25-104",
            "bic": "GLUALT22XXX",
            "bankAccountNumber": "LT613880005539913436",
            "correspondentBankName": "PAYSWIX, UAB",
            "correspondentBankAccountNumber": "LT613880005539913436",
            "correspondentBankCode": null,
            "sortCode": null,
            "bankCode": null,
            "ultimateDebtorName": null,
            "ultimateBeneficiaryName": null,
            "bankAccountNumberTag": null,
            "purpose": null,
            "categoryPurpose": null,
            "paymentPurpose": null,
            "lei": null
        },
        "createdAt": "2026-04-07T11:10:26+00:00",
        "executionTime": null,
        "processingTime": null,
        "updatedAt": "2026-04-07T11:10:26+00:00",
        "chargeType": null,
        "urgency": null,
        "partnerId": null,
        "settlementDate": "2026-04-07T11:10:26+00:00",
        "directDebitMandateId": null,
        "directDebitPaymentId": null,
        "initiatedAt": null,
        "finalizedAt": null
    },
    "message": null
}
Previous
Create a SEPA transfer
Next
Transaction
Built with