Batch Payment Export

Export outbound payments in bank-uploadable formats for bulk processing.

Supported Formats

Format	Use Case	File Type
UAEFTS	UAE Funds Transfer System (bank transfers)	`.txt` (pipe-delimited)
CSV	Generic bank import	`.csv`
WPS/SIF	UAE Wage Protection System (salary payments)	`.SIF`

Workflow

1. List Exportable Payments


GET /api/v1/accounting/batch-payment/exportable?date_from=2026-04-01&date_to=2026-04-30

Returns posted outbound payments that haven’t been exported yet.

2. Export

UAEFTS Format


POST /api/v1/accounting/batch-payment/export/uaefts
{
  "payment_ids": ["uuid1", "uuid2", "uuid3"],
  "company_name": "Arkan Trading LLC",
  "sender_bank": {
    "bank_name": "Emirates NBD",
    "account_number": "1234567890",
    "iban": "AE123456789012345678",
    "swift_code": "EABORKAXXXX"
  }
}

Returns a downloadable .txt file with header, detail lines, and trailer.

CSV Format


POST /api/v1/accounting/batch-payment/export/csv
{
  "payment_ids": ["uuid1", "uuid2"]
}

WPS/SIF Format (Salary Payments)


POST /api/v1/accounting/batch-payment/export/wps
{
  "payment_ids": ["uuid1", "uuid2"],
  "employer_eid": "12345678901234",
  "bank_routing_code": "ENBD",
  "salary_month": "2026-04"
}

3. Manage Bank Details

Before exporting, set up beneficiary bank details:


PUT /api/v1/accounting/batch-payment/bank-details/{partnerId}
{
  "bank_name": "Abu Dhabi Commercial Bank",
  "account_number": "9876543210",
  "iban": "AE987654321098765432",
  "swift_code": "ADCBAEAA"
}

UAEFTS File Format


HDR|BATCHREF|Company Name|Account|IBAN|20260414|15000.00|3
DTL|0001|Vendor A|ACCT123|IBAN123|Bank A|5000.00|AED|PO-001
DTL|0002|Vendor B|ACCT456|IBAN456|Bank B|7000.00|AED|PO-002
DTL|0003|Vendor C|ACCT789|IBAN789|Bank C|3000.00|AED|PO-003
TRL|3|15000.00

Export Tracking

Exported payments are tagged with [EXPORTED:BATCHREF:timestamp] in the memo field to prevent duplicate exports.