Batch payments

Batch Payments

The Batch Payment feature allows customers to initiate multiple payments within a single checkout request, providing flexibility and efficiency for complex payment scenarios.

Same-day Payments

Process multiple immediate payments in a single batch transaction

Scheduled Payments

Schedule multiple future payments with specified execution dates

Mixed Payments

Combine both same-day and scheduled payments in one batch

Key Features

Customers can:

  • Send same-day payments in a batch
  • Send scheduled payments in a batch
  • Mix both same-day and scheduled payments in a single batch
  • Track the status of each payment separately with individual notifications
Bank Support Information

Important: When a batch payment is initiated, the checkout will only display banks that support batch payments.

If no banks support batch payments, an error will be shown to the user. Please ensure your integration handles this scenario appropriately.

The status of each payment will be tracked and notified separately, allowing for granular monitoring of batch payment progress.

Implementation Examples

API Endpoint: https://checkout.sandbox.neonomics.io/api/v2/checkout-requests

Sample Request

Request Header:

api-key: 31mkl-hfy23-312kj-f8qw…

Request Body

{
  "referenceId": "41212",
  "clientName": "Awesome Scooters AS",
  "successUrl": "https://merchant.com/order/41212/success",
  "failUrl": "https://merchant.com/order/41212/fail",
  "cancelUrl": "https://merchant.com/order/41212/cancel",
  "language": "EN",
  "paymentRequests": [
    {
      "amount": 20,
      "currency": "NOK",
      "remittanceInfo": "Something we need to 1",
      "creditorAccount": {
        "creditorName": "VJ",
        "bban": "86011117947"
      },
      "creditorAddress": {
        "creditorStreetName": "test1",
        "creditorBuildingNumber": "test1",
        "creditorPostalCode": "test1",
        "creditorCity": "test1",
        "creditorCountry": "NO"
      }
    },
    {
      "amount": 10,
      "currency": "NOK",
      "remittanceInfo": "Something we need to 2",
      "creditorAccount": {
        "creditorName": "JK",
        "bban": "30803590687"
      },
      "creditorAddress": {
        "creditorStreetName": "test2",
        "creditorBuildingNumber": "test2",
        "creditorPostalCode": "test2",
        "creditorCity": "test2",
        "creditorCountry": "NO"
      }
    }
  ]
}

Sample Response

{
    "redirectUrl": "https://checkout.development.neonomics.io/api/v2/checkout-requests/193193b3-5a8e-4778-aa56-da7ef44279a8/app",
    "id": "193193b3-5a8e-4778-aa56-da7ef44279a8"
}

User Interface Examples

Here are some user interface examples showing how batch payments appear during the checkout payment journey: