Batch payments

The Batch Payment feature allows customers to initiate multiple payments within a single checkout request.

Customers can:

  • Send same-day payments in a batch
  • Send scheduled payments in a batch
  • Or mix both same-day and scheduled payments in a single batch

Bank Support

  • 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.

The status of each payment will be tracked and notified separately.Please refer to the section below for the supported batch payment combinations.

Batch payment - same day payments

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

Sample request

{
  "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"
}

Batch payment - scheduled payments

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

Sample request

{
  "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 provide",
      "creditorAccount": {
        "creditorName": "VJ",
        "bban": "86011117947"
      },
      "creditorAddress": {
        "creditorStreetName": "test",
        "creditorBuildingNumber": "test build",
        "creditorPostalCode": "postal",
        "creditorCity": "city",
        "creditorCountry": "NO"
      },
      "paymentScheduledDate": "2025-08-24"
    },

    {
      "amount": 20,
      "currency": "NOK",
      "remittanceInfo": "Something we need to provide",
      
      "creditorAccount": {
        "creditorName": "JK",
        "bban": "30803590687"
      },
      "creditorAddress": {
        "creditorStreetName": "test",
        "creditorBuildingNumber": "test build",
        "creditorPostalCode": "postal",
        "creditorCity": "city",
        "creditorCountry": "NO"
      },
      "paymentScheduledDate": "2025-08-24"
    }
  ]
}

Sample response

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

Batch payment - mixed(same day and scheduled)

Sample request

{
  "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": 10,
      "currency": "NOK",
      "remittanceInfo": "Something we need to provide1",
      "creditorAccount": {
        "creditorName": "VJ",
        "bban": "86011117947"
      },
      "creditorAddress": {
        "creditorStreetName": "test1",
        "creditorBuildingNumber": "test1",
        "creditorPostalCode": "test1",
        "creditorCity": "test1",
        "creditorCountry": "NO"
      },
      "paymentScheduledDate": "2025-08-27"
    },

    {
      "amount": 30,
      "currency": "NOK",
      "remittanceInfo": "Something we need to provide2",
      
      "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"
}

Here are some user interfaces how it will looks during the checkout payment journey