Create payment

cURL

curl --request POST \
  --url https://api.maesn.dev/accounting/payments \
  --header 'Content-Type: application/json' \
  --header 'X-ACCOUNT-KEY: <x-account-key>' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '
{
  "currency": "EUR",
  "exchangeRate": 1,
  "journalCode": "30",
  "paymentLines": [
    {
      "accountId": "4a6b5e92-a261-4be9-814d-84dec9636c16",
      "amount": 100,
      "description": "payment of bill",
      "invoiceId": "a44f5af1-8310-4f97-b945-26e35288b35f",
      "paymentDate": "2025-01-01",
      "supplierId": "supplier id"
    }
  ],
  "paymentType": "CREDITOR"
}
'

{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 125,
      "perPage": 50,
      "currentPage": 1,
      "totalPages": 3
    }
  },
  "data": {
    "id": "94a5ab44-3218-4492-8b5d-a31bc0288c0b",
    "currency": "EUR",
    "createdDate": "2021-01-01T00:00:00Z",
    "exchangeRate": 1,
    "journalCode": "30",
    "updatedDate": "2021-01-01T00:00:00Z",
    "paymentLines": [
      {
        "accountId": "4a6b5e92-a261-4be9-814d-84dec9636c16",
        "amount": 100,
        "description": "payment of bill",
        "invoiceId": "a44f5af1-8310-4f97-b945-26e35288b35f",
        "paymentDate": "2025-01-01",
        "supplierId": "supplier id"
      }
    ],
    "paymentType": "CREDITOR"
  }
}

POST

accounting

payments

cURL

curl --request POST \
  --url https://api.maesn.dev/accounting/payments \
  --header 'Content-Type: application/json' \
  --header 'X-ACCOUNT-KEY: <x-account-key>' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '
{
  "currency": "EUR",
  "exchangeRate": 1,
  "journalCode": "30",
  "paymentLines": [
    {
      "accountId": "4a6b5e92-a261-4be9-814d-84dec9636c16",
      "amount": 100,
      "description": "payment of bill",
      "invoiceId": "a44f5af1-8310-4f97-b945-26e35288b35f",
      "paymentDate": "2025-01-01",
      "supplierId": "supplier id"
    }
  ],
  "paymentType": "CREDITOR"
}
'

{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 125,
      "perPage": 50,
      "currentPage": 1,
      "totalPages": 3
    }
  },
  "data": {
    "id": "94a5ab44-3218-4492-8b5d-a31bc0288c0b",
    "currency": "EUR",
    "createdDate": "2021-01-01T00:00:00Z",
    "exchangeRate": 1,
    "journalCode": "30",
    "updatedDate": "2021-01-01T00:00:00Z",
    "paymentLines": [
      {
        "accountId": "4a6b5e92-a261-4be9-814d-84dec9636c16",
        "amount": 100,
        "description": "payment of bill",
        "invoiceId": "a44f5af1-8310-4f97-b945-26e35288b35f",
        "paymentDate": "2025-01-01",
        "supplierId": "supplier id"
      }
    ],
    "paymentType": "CREDITOR"
  }
}

Field support per integration

Exact

If you’re not using the Interactive Authentication Flow, make sure the query parameter companyId is correctly populated. You can obtain this value by using the GET Companies endpoint available under the Authentication section.

Supported Request Fields:

currency

string

exchangeRate

number

journalCode

string

required

paymentLines

PaymentLine[]

Show properties

amount

number

required

accountId

string

required

description

string

invoiceId

string

paymentDate

string

supplierId

string

required

Xero

Supported Request Fields:

exchangeRate

number

paymentLines

PaymentLine[]

Show properties

amount

number

required

accountId

string

required

Id of the bank account to which the payment is made. Needs to be type BANK.To get the correct id, you can use the GET Accounts endpoint.

description

string

invoiceId

string

required

paymentDate

string

required

Headers

X-API-KEY

string

required

API key

Example:

"example value"

X-ACCOUNT-KEY

string

required

Account key

Example:

"example value"

Query Parameters

companyId

string

Body

application/json

currency

enum<string>

Available options:

AED,

AFN,

ALL,

AMD,

ANG,

AOA,

ARS,

AUD,

AWG,

AZN,

BAM,

BBD,

BDT,

BGN,

BHD,

BIF,

BMD,

BND,

BOB,

BRL,

BSD,

BTN,

BWP,

BYR,

BZD,

CAD,

CDF,

CHF,

CLP,

CNY,

COP,

CRC,

CUC,

CVE,

CZK,

DJF,

DKK,

DOP,

DZD,

EEK,

EGP,

ERN,

ETB,

EUR,

FJD,

FKP,

GBP,

GEL,

GHS,

GIP,

GMD,

GNF,

GQE,

GTQ,

GYD,

HKD,

HNL,

HRK,

HTG,

HUF,

IDR,

ILS,

INR,

IQD,

IRR,

ISK,

JMD,

JOD,

JPY,

KES,

KGS,

KHR,

KMF,

KPW,

KRW,

KWD,

KYD,

KZT,

LAK,

LBP,

LKR,

LRD,

LSL,

LTL,

LVL,

LYD,

MAD,

MDL,

MGA,

MKD,

MMK,

MNT,

MOP,

MRO,

MUR,

MVR,

MWK,

MXN,

MYR,

MZM,

NAD,

NGN,

NIO,

NOK,

NPR,

NZD,

OMR,

PAB,

PEN,

PGK,

PHP,

PKR,

PLN,

PYG,

QAR,

RON,

RSD,

RUB,

SAR,

SBD,

SCR,

SDG,

SEK,

SGD,

SHP,

SLL,

SOS,

SRD,

SYP,

SZL,

THB,

TJS,

TMT,

TND,

TRY,

TTD,

TWD,

TZS,

UAH,

UGX,

USD,

UYU,

UZS,

VEB,

VND,

VUV,

WST,

XAF,

XCD,

XDR,

XOF,

XPF,

YER,

ZAR,

ZMK,

ZWR

Example:

"EUR"

exchangeRate

number

Example:

1

journalCode

string

Example:

"30"

paymentLines

object[]

Show child attributes

paymentLines.accountId

string

Example:

"4a6b5e92-a261-4be9-814d-84dec9636c16"

paymentLines.amount

number

Example:

100

paymentLines.description

string

Example:

"payment of bill"

paymentLines.invoiceId

string

Example:

"a44f5af1-8310-4f97-b945-26e35288b35f"

paymentLines.paymentDate

string

Example:

"2025-01-01"

paymentLines.supplierId

string

Example:

"supplier id"

paymentType

string

Example:

"CREDITOR"

Response

200 - application/json

Get started

Guides

Integrations

Use cases

API reference

Create payment

Field support per integration

Headers

Query Parameters

Body

Response

Get started

Guides

Integrations

Use cases

API reference

​Field support per integration

Headers

Query Parameters

Body

Response

Field support per integration