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.
Field | Type | Required | Description |
---|---|---|---|
batchId | string | No | Partner's internal reference for the payment. Must be unique per payment or left empty. Used to ensure the same payment is not created twice. |
amount | decimal | Yes | Amount to be transferred to the recipient. |
senderBankAccount | string | Yes | The 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. |
recipientName | string | Yes | Recipient’s name. |
recipientAddress | object | No | Recipient’s address. If provided, use camelCase subfields (street , postalCode , city , and countryCode for ISO-2 like DK ) to stay consistent across your integration. |
recipientAccountNumber | string | Yes | Recipient’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 |
recipientEmail | string | No | Recipient’s email address. If provided, a payment receipt will be sent to the recipient. |
message | string | No | Message sent with the payment, visible to the recipient in their bank account. |
dueDate | date (YYYY-MM-DD) | Yes | Date on which the payment must be executed. Must be a valid banking day. |
webHookURL | string | No | URL for receiving real-time updates and changes related to the payment. If not provided, the partner’s default webhook (if configured) will be used. |
externalPartnerUserName | string | No | Partner’s internal reference to the user in their system who created the payment. |
invoiceNumber | string | No | Invoice 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"
}