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,
  "fiscalYear": "2025",
  "journalCode": "30",
  "paymentLines": [
    {
      "accountId": "4a6b5e92-a261-4be9-814d-84dec9636c16",
      "amount": 100,
      "contactName": "John Doe",
      "contactId": "6532708-12e3-4ff5-bf39-02698e959963",
      "customerId": "6532708-12e3-4ff5-bf39-02698e959963",
      "description": "payment of bill",
      "invoiceId": "a44f5af1-8310-4f97-b945-26e35288b35f",
      "paymentDate": "2025-01-01",
      "supplierId": "6532708-12e3-4ff5-bf39-02698e959963"
    }
  ],
  "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,
    "fiscalYear": "2025",
    "journalCode": "30",
    "updatedDate": "2021-01-01T00:00:00Z",
    "paymentLines": [
      {
        "accountId": "4a6b5e92-a261-4be9-814d-84dec9636c16",
        "amount": 100,
        "contactName": "John Doe",
        "contactId": "6532708-12e3-4ff5-bf39-02698e959963",
        "customerId": "6532708-12e3-4ff5-bf39-02698e959963",
        "description": "payment of bill",
        "invoiceId": "a44f5af1-8310-4f97-b945-26e35288b35f",
        "paymentDate": "2025-01-01",
        "supplierId": "6532708-12e3-4ff5-bf39-02698e959963"
      }
    ],
    "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,
  "fiscalYear": "2025",
  "journalCode": "30",
  "paymentLines": [
    {
      "accountId": "4a6b5e92-a261-4be9-814d-84dec9636c16",
      "amount": 100,
      "contactName": "John Doe",
      "contactId": "6532708-12e3-4ff5-bf39-02698e959963",
      "customerId": "6532708-12e3-4ff5-bf39-02698e959963",
      "description": "payment of bill",
      "invoiceId": "a44f5af1-8310-4f97-b945-26e35288b35f",
      "paymentDate": "2025-01-01",
      "supplierId": "6532708-12e3-4ff5-bf39-02698e959963"
    }
  ],
  "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,
    "fiscalYear": "2025",
    "journalCode": "30",
    "updatedDate": "2021-01-01T00:00:00Z",
    "paymentLines": [
      {
        "accountId": "4a6b5e92-a261-4be9-814d-84dec9636c16",
        "amount": 100,
        "contactName": "John Doe",
        "contactId": "6532708-12e3-4ff5-bf39-02698e959963",
        "customerId": "6532708-12e3-4ff5-bf39-02698e959963",
        "description": "payment of bill",
        "invoiceId": "a44f5af1-8310-4f97-b945-26e35288b35f",
        "paymentDate": "2025-01-01",
        "supplierId": "6532708-12e3-4ff5-bf39-02698e959963"
      }
    ],
    "paymentType": "CREDITOR"
  }
}

Field support per integration

Business Central

If you’re not using the Interactive Authentication Flow, make sure the query parameters environmentName and companyId are correctly populated. You can obtain these values by using the GET Environments and GET Companies endpoints available under the Authentication section.

Supported request fields:

journalCode

string

required

Code of the supplier or customer payment journal in Business Central (e.g. CASH).

paymentLines

PaymentLine[]

required

Show properties

contactId

string

required

GUID of the supplier or customer in Business Central. The type is auto-detected — if the ID matches a customer, a customer payment is created; if it matches a vendor, a vendor payment is created.

amount

number

required

paymentDate

string

required

For date format details visit the Standardized Data section

invoiceId

string

GUID of the purchase or sales invoice to apply the payment to.

description

string

Exact Online

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

contactId

string

description

string

invoiceId

string

paymentDate

string

Lexware Office

Supported Request Fields:

paymentLines

PaymentLine[]

required

Show properties

accountId

string

required

amount

number

required

contactName

string

description

string

required

paymentDate

string

required

Sevdesk

Supported Request Fields:

paymentLines

PaymentLine[]

required

Show properties

accountId

string

required

amount

number

required

contactName

string

required

invoiceId

string

required

paymentDate

string

required

Visma e-conomic

Supported Request Fields:

currency

string

required

journalCode

string

required

paymentLines

PaymentLine[]

required

Show properties

accountId

string

required

amount

number

required

customerId

string

required

description

string

invoiceId

string

required

paymentDate

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

environmentName

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

fiscalYear

string

Example:

"2025"

journalCode

string

Example:

"30"

paymentLines

object[]

Show child attributes

paymentType

string

Example:

"CREDITOR"

Response

200 - application/json

​Field support per integration

Headers

Query Parameters

Body

Response

Field support per integration