Local Payment body fields

Below is a description of all fields available in the POST /v2/local/payments request body.

Required fields must be provided to successfully create a payment.

FieldTypeRequiredDescription
batchIdstringNoPartner's internal reference for the payment. Must be unique per payment or left empty. Used to ensure the same payment is not created twice.
amountdecimalYesAmount to be transferred to the recipient.
senderBankAccountstringYesThe bank account from which the amount will be debited – i.e., the November First customer’s account. Requires an active Overførselsservice agreement for auto-initiation.
recipientNamestringYesRecipient’s name.
recipientAddressobjectNoRecipient’s address. If provided, use camelCase subfields (street, postalCode, city, and countryCode for ISO-2 like DK) to stay consistent across your integration.
recipientAccountNumberstringYesRecipient’s Danish account and registration number combined in a single 14-digit string. Leading zeros may occur, so handle it as a string, not a number. This field is also supporting domestic Danish FIK OCR lines like +04, +71, +73, and +75
recipientEmailstringNoRecipient’s email address. If provided, a payment receipt will be sent to the recipient.
messagestringNoMessage sent with the payment, visible to the recipient in their bank account.
dueDatedate (YYYY-MM-DD)YesDate on which the payment must be executed. Must be a valid banking day.
webHookURLstringNoURL for receiving real-time updates and changes related to the payment. If not provided, the partner’s default webhook (if configured) will be used.
externalPartnerUserNamestringNoPartner’s internal reference to the user in their system who created the payment.
invoiceNumberstringNoInvoice or receipt number for the payment.

Example Request – Local Payment

{
  "batchId": "ABC123",
  "amount": 1250.00,
  "senderBankAccount": "12345678901234",
  "recipientName": "John Doe",
  "recipientAddress": {
    "street": "Main Street 12",
    "postalCode": "1000",
    "city": "Copenhagen",
    "countryCode": "DK"
  },
  "recipientAccountNumber": "98765432101234",
  "recipientEmail": "[email protected]",
  "message": "Invoice 12345",
  "dueDate": "2025-09-10",
  "webHookURL": "https://partner.example.com/webhook",
  "externalPartnerUserName": "api-user-1",
  "invoiceNumber": "INV-2025-09-001"
}