Payments

Add Payment

post

Required scopes

This endpoint requires the following scopes:

• : Access Younium API

Authorizations

oauth2

OAuth2passwordRequired

Token URL:

Header parameters

api-versionstringOptional

younium-idempotency-keystringOptional

younium-idempotency-durationInHoursintegerOptional

Body

application/json

paymentDatestring · date-timeOptional

amountnumber · doubleOptional

bankFeeAmountnumber · doubleOptional

exchangeRatenumber · double · nullableOptional

baseCurrencyAmountnumber · double · nullableOptional

payerNamestring · nullableOptional

payerInformationstring · nullableOptional

referencestring · nullableOptional

descriptionstring · nullableOptional

externalBankIdstring · nullableOptional

Responses

201

Created

No content

400

Bad Request.

application/json

401

Unauthorized

403

Forbidden

post/Payments

HTTPcURLJavaScriptPython

POST /Payments HTTP/1.1
Host: api.younium.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 393

{
  "paymentDate": "2026-07-14T14:35:18.583Z",
  "currency": "SEK",
  "amount": 1,
  "bankFeeAmount": 1,
  "exchangeRate": 1,
  "baseCurrencyAmount": 1,
  "paymentAccount": "1510",
  "BankFeeAccount": "1510",
  "paymentMethod": "Standard",
  "paymentWriteOffs": [
    {
      "amount": 1,
      "postingText": "text",
      "financialAccount": "1510"
    }
  ],
  "payerName": "text",
  "payerInformation": "text",
  "reference": "text",
  "description": "text",
  "externalBankId": "text"
}

No content

Get Payments

get

Required scopes

This endpoint requires the following scopes:

• : Access Younium API

Authorizations

oauth2

OAuth2passwordRequired

Token URL:

Query parameters

FilterstringOptional

Filter the results. See developer resources for more information. On endpoints whose entity supports custom fields you can also filter by custom field: customFieldEq('fieldName', 'value') (equals) or customFieldExist('fieldName') (field has a non-empty value). Custom-field functions may only be combined with and.

Example: name eq 'Adam' and age gt 20 and customFieldEq('region', 'EU')

OrderBystringOptional

Sorting the results. See developer resources for more information

Example: accountNumber Desc

ModifiedAfterstring · date-timeOptional

Apply a separate modified After filter. See 'ModifiedBefore' filter for further details.

Example: 2026-07-01

ModifiedBeforestring · date-timeOptional

Filter is also applied on sub entities: 'paymentSettlements' and 'writeOffs'

Example: 2026-07-01

PageSizeinteger · int32Optional

Page Size

Example: 20

PageNumberinteger · int32Optional

Page Number

Example: 1

Header parameters

api-versionstringOptional

Responses

200

Success

application/json

pageNumberinteger · int32Optional

pageSizeinteger · int32Optional

totalPagesinteger · int32 · nullableOptional

totalCountinteger · int32Optional

nextPagestring · uri · nullableOptional

previousPagestring · uri · nullableOptional

firstPagestring · uri · nullableOptional

lastPagestring · uri · nullableOptional

400

Bad Request.

application/json

401

Unauthorized

403

Forbidden

get/Payments

HTTPcURLJavaScriptPython

GET /Payments HTTP/1.1
Host: api.younium.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "pageNumber": 1,
  "pageSize": 1,
  "totalPages": 1,
  "totalCount": 1,
  "nextPage": "https://example.com",
  "previousPage": "https://example.com",
  "firstPage": "https://example.com",
  "lastPage": "https://example.com",
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "payerName": "text",
      "payerInformation": "text",
      "paymentDate": "2026-07-14T14:35:18.583Z",
      "postedDate": "2026-07-14T14:35:18.583Z",
      "reference": "text",
      "description": "text",
      "amount": {
        "amount": 1,
        "currencyCode": "text",
        "currencyConversionDate": "2026-07-14T14:35:18.583Z",
        "baseCurrencyAmount": 1,
        "baseCurrencyCode": "text"
      },
      "bankFeeAmount": {
        "amount": 1,
        "currencyCode": "text",
        "currencyConversionDate": "2026-07-14T14:35:18.583Z",
        "baseCurrencyAmount": 1,
        "baseCurrencyCode": "text"
      },
      "exchangeRate": 1,
      "paymentAccount": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "code": "text",
        "name": "text",
        "description": "text",
        "externalERPId": "text",
        "externalCRMId": "text"
      },
      "BankFeeAccount": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "code": "text",
        "name": "text",
        "description": "text",
        "externalERPId": "text",
        "externalCRMId": "text"
      },
      "paymentMethodName": "text",
      "paymentMethodId": "123e4567-e89b-12d3-a456-426614174000",
      "paymentBatchNumber": "text",
      "paymentBatchId": "123e4567-e89b-12d3-a456-426614174000",
      "paymentSettlements": [
        {
          "amount": {
            "amount": 1,
            "currencyCode": "text",
            "currencyConversionDate": "2026-07-14T14:35:18.583Z",
            "baseCurrencyAmount": 1,
            "baseCurrencyCode": "text"
          },
          "invoice": {
            "account": {
              "name": "text",
              "accountNumber": "text",
              "id": "123e4567-e89b-12d3-a456-426614174000",
              "externalERPId": "text",
              "externalCRMId": "text"
            },
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "invoiceNumber": "text",
            "status": "Draft",
            "invoiceDate": "2026-07-14T14:35:18.583Z",
            "dueDate": "2026-07-14T14:35:18.583Z",
            "buyerReference": "text",
            "ocrNumber": "text",
            "currency": "text",
            "subtotal": 1,
            "tax": 1,
            "totalAmount": 1,
            "settledAmount": 1,
            "externalERPId": "text",
            "externalCRMId": "text"
          },
          "writeOffs": [
            {
              "id": "123e4567-e89b-12d3-a456-426614174000",
              "amount": {
                "amount": 1,
                "currencyCode": "text",
                "currencyConversionDate": "2026-07-14T14:35:18.583Z",
                "baseCurrencyAmount": 1,
                "baseCurrencyCode": "text"
              },
              "postingText": "text",
              "financialAccount": {
                "id": "123e4567-e89b-12d3-a456-426614174000",
                "code": "text",
                "name": "text",
                "description": "text",
                "externalERPId": "text",
                "externalCRMId": "text"
              }
            }
          ]
        }
      ],
      "paymentWriteOffs": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "amount": {
            "amount": 1,
            "currencyCode": "text",
            "currencyConversionDate": "2026-07-14T14:35:18.583Z",
            "baseCurrencyAmount": 1,
            "baseCurrencyCode": "text"
          },
          "postingText": "text",
          "financialAccount": {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "code": "text",
            "name": "text",
            "description": "text",
            "externalERPId": "text",
            "externalCRMId": "text"
          }
        }
      ],
      "externalBankId": "text",
      "onlinePaymentIntentId": "text",
      "onlinePaymentChargeId": "text"
    }
  ]
}

Update Payment

patch

Update Payment details and Add, remove or edit payment settlements and write offs.

Required scopes

This endpoint requires the following scopes:

• : Access Younium API

Authorizations

oauth2

OAuth2passwordRequired

Token URL:

Path parameters

idstring · uuidRequired

Header parameters

api-versionstringOptional

Body

application/merge-patch+json

paymentDatestring · date-time · nullableOptional

payerNamestring · nullableOptional

payerInformationstring · nullableOptional

referencestring · nullableOptional

descriptionstring · nullableOptional

externalBankIdstring · nullableOptional

Responses

200

Success

No content

400

Bad Request.

application/json

401

Unauthorized

403

Forbidden

patch/Payments/{id}

HTTPcURLJavaScriptPython

PATCH /Payments/{id} HTTP/1.1
Host: api.younium.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/merge-patch+json
Accept: */*
Content-Length: 463

{
  "paymentDate": "2026-07-14T14:35:18.583Z",
  "paymentWriteOffs": [
    {
      "operation": "Change",
      "writeOff": "GUID",
      "amount": 1,
      "postingText": "text",
      "financialAccount": "1510"
    }
  ],
  "paymentSettlements": [
    {
      "operation": "Change",
      "invoice": "IP-000001",
      "amount": 1,
      "writeOffs": [
        {
          "operation": "Change",
          "writeOff": "GUID",
          "amount": 1,
          "postingText": "text",
          "financialAccount": "1510"
        }
      ]
    }
  ],
  "payerName": "text",
  "payerInformation": "text",
  "reference": "text",
  "description": "text",
  "externalBankId": "text"
}

No content

Get Payments by Id

get

Required scopes

This endpoint requires the following scopes:

• : Access Younium API

Authorizations

oauth2

OAuth2passwordRequired

Token URL:

Path parameters

idstring · uuidRequired

Header parameters

api-versionstringOptional

Responses

200

Success

application/json

idstring · uuidOptional

payerNamestring · nullableOptional

payerInformationstring · nullableOptional

paymentDatestring · date-timeOptional

postedDatestring · date-time · nullableOptional

referencestring · nullableOptional

descriptionstring · nullableOptional

exchangeRatenumber · double · nullableOptional

paymentMethodNamestring · nullableOptional

paymentMethodIdstring · uuid · nullableOptional

paymentBatchNumberstring · nullableOptional

paymentBatchIdstring · uuidOptional

externalBankIdstring · nullableOptional

onlinePaymentIntentIdstring · nullableOptional

onlinePaymentChargeIdstring · nullableOptional

400

Bad Request.

application/json

401

Unauthorized

403

Forbidden

404

Not Found

application/json

get/Payments/{id}

HTTPcURLJavaScriptPython

GET /Payments/{id} HTTP/1.1
Host: api.younium.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "payerName": "text",
  "payerInformation": "text",
  "paymentDate": "2026-07-14T14:35:18.583Z",
  "postedDate": "2026-07-14T14:35:18.583Z",
  "reference": "text",
  "description": "text",
  "amount": {
    "amount": 1,
    "currencyCode": "text",
    "currencyConversionDate": "2026-07-14T14:35:18.583Z",
    "baseCurrencyAmount": 1,
    "baseCurrencyCode": "text"
  },
  "bankFeeAmount": {
    "amount": 1,
    "currencyCode": "text",
    "currencyConversionDate": "2026-07-14T14:35:18.583Z",
    "baseCurrencyAmount": 1,
    "baseCurrencyCode": "text"
  },
  "exchangeRate": 1,
  "paymentAccount": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "code": "text",
    "name": "text",
    "description": "text",
    "externalERPId": "text",
    "externalCRMId": "text"
  },
  "BankFeeAccount": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "code": "text",
    "name": "text",
    "description": "text",
    "externalERPId": "text",
    "externalCRMId": "text"
  },
  "paymentMethodName": "text",
  "paymentMethodId": "123e4567-e89b-12d3-a456-426614174000",
  "paymentBatchNumber": "text",
  "paymentBatchId": "123e4567-e89b-12d3-a456-426614174000",
  "paymentSettlements": [
    {
      "amount": {
        "amount": 1,
        "currencyCode": "text",
        "currencyConversionDate": "2026-07-14T14:35:18.583Z",
        "baseCurrencyAmount": 1,
        "baseCurrencyCode": "text"
      },
      "invoice": {
        "account": {
          "name": "text",
          "accountNumber": "text",
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "externalERPId": "text",
          "externalCRMId": "text"
        },
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "invoiceNumber": "text",
        "status": "Draft",
        "invoiceDate": "2026-07-14T14:35:18.583Z",
        "dueDate": "2026-07-14T14:35:18.583Z",
        "buyerReference": "text",
        "ocrNumber": "text",
        "currency": "text",
        "subtotal": 1,
        "tax": 1,
        "totalAmount": 1,
        "settledAmount": 1,
        "externalERPId": "text",
        "externalCRMId": "text"
      },
      "writeOffs": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "amount": {
            "amount": 1,
            "currencyCode": "text",
            "currencyConversionDate": "2026-07-14T14:35:18.583Z",
            "baseCurrencyAmount": 1,
            "baseCurrencyCode": "text"
          },
          "postingText": "text",
          "financialAccount": {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "code": "text",
            "name": "text",
            "description": "text",
            "externalERPId": "text",
            "externalCRMId": "text"
          }
        }
      ]
    }
  ],
  "paymentWriteOffs": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "amount": {
        "amount": 1,
        "currencyCode": "text",
        "currencyConversionDate": "2026-07-14T14:35:18.583Z",
        "baseCurrencyAmount": 1,
        "baseCurrencyCode": "text"
      },
      "postingText": "text",
      "financialAccount": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "code": "text",
        "name": "text",
        "description": "text",
        "externalERPId": "text",
        "externalCRMId": "text"
      }
    }
  ],
  "externalBankId": "text",
  "onlinePaymentIntentId": "text",
  "onlinePaymentChargeId": "text"
}

Create and Post Payment

post

Required scopes

This endpoint requires the following scopes:

• : Access Younium API

Authorizations

oauth2

OAuth2passwordRequired

Token URL:

Header parameters

api-versionstringOptional

younium-idempotency-keystringOptional

younium-idempotency-durationInHoursintegerOptional

Body

application/json

descriptionstring · nullableOptional

paymentDatestring · date-timeOptional

amountnumber · doubleOptional

bankFeeAmountnumber · doubleOptional

exchangeRatenumber · double · nullableOptional

baseCurrencyAmountnumber · double · nullableOptional

Responses

201

Created

application/json

idstring · uuid · nullableOptional

messagestring · nullableOptional

400

Bad Request.

application/json

401

Unauthorized

403

Forbidden

post/Payments/CreateAndPost

HTTPcURLJavaScriptPython

POST /Payments/CreateAndPost HTTP/1.1
Host: api.younium.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 223

{
  "invoice": {
    "key": "text",
    "value": "text"
  },
  "description": "text",
  "paymentDate": "2026-07-14T14:35:18.583Z",
  "amount": 1,
  "bankFeeAmount": 1,
  "exchangeRate": 1,
  "baseCurrencyAmount": 1,
  "paymentAccount": "1510",
  "paymentMethod": "Standard"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "message": "text"
}

---