Payment

Register payment order

Read more about the Payment life cycle in the Developer resources

post/psu/{psuId}/payment-order

Request

  • Base URL: https://bankapidemo.svea.com
  • URL: https://bankapidemo.svea.com/psu/{psuId}/payment-order
  • Auth: Bearer (a scheme the document does not define)

Path parameters

psuIdstring uuid required
Example:febbe8f2-bd6b-4e53-89c6-e89ca92ff5ee

Headers

Authorizationstring required
Example:Bearer {BearerToken}
X-Svea-ClientAppstring required

Tenant client app name, version, and optional comment <client-app-name>/<version>(/<comment>)

Example:TENANT-IOS/0.99.0
X-Svea-CorrelationIdstring uuid

The correlationId is a unique identifier value that is attached to requests and messages that allow reference to a particular transaction or event chain. Used to follow transaction information, especially for logging purposes.

Example:21436a05-d62d-4f29-a253-31b3815d148b
X-Svea-SessionIdstring uuid

The sessionId is a unique identifier value for a users session. This identifier should be the same for the entire duration of that users session. Mainly used for logging and troubleshooting purposes.

Example:afe56332-dee2-48b4-ae0b-d694a6174a7e

Request body

amountstring required
creditorType'swedishBankAccount' | 'ownBankAccount' | 'bankGiro' | 'plusGiro' | 'preregisteredIban' required

Note! New creditorTypes might be added at any time and it's up to the client how to handle unknown values.

currency'SEK' | 'EUR' | 'NOK' | 'USD' | 'GBP' | 'DKK' | 'PLN' | 'RON' | 'CZK' | 'HUF' | 'ISK' | 'CHF' required

Currencies other than SEK is only allowed for Iban payments

externalPaymentReferencestring nullable

Can be used by external parties to connect a payment through it's lifecycle with a resource on their side.

Example request

{
  "amount": "123.00",
  "creditor": {
    "bankAccountNumber": "8003150359",
    "clearingNumber": "3300",
    "message": "A message",
    "name": "Sven Svensson"
  },
  "creditorType": "swedishBankAccount",
  "currency": "SEK",
  "debtor": {
    "bankAccountId": "ad5acb9d-a11a-4533-bf6a-870a2217bcfb",
    "message": "Description"
  },
  "externalPaymentReference": "Invoice #42",
  "paymentDate": "2026-10-12"
}

Response

OK

paymentOrderIdstring uuid required

Example response

{
  "paymentOrderId": "d0125fa2-daf7-4e8b-a198-46e2c708918e"
}

Changes

No recorded changes to this operation across all 1 revision of this API.