Batchgate
Table of Contents
Overview
The Batchgate service enables corporates to integrate their ERP solutions with the platform. Through this integration, corporates can prepare payment schedules such as salary, vendor, and other bulk payments directly from their ERP systems.
The generated payment schedule will be transmitted to the Batchgate service via a dedicated SFTP location. During the integration and go-live process, the corporate will be provided with access to an SFTP directory, where payment files should be uploaded to the /IN folder for processing.
SFTP
SFTP (Secure File Transfer Protocol) is a secure network protocol used to transfer files between systems over an encrypted connection. It operates over SSH (Secure Shell), ensuring that files, credentials, and data exchanged between parties are protected from unauthorized access.
In the context of Batchgate, SFTP serves as the secure channel through which corporates exchange payment files and processing results with the platform:
- /IN Folder – Used by the corporate to upload payment schedules for processing.
- /OUT Folder – Used by Batchgate to return transaction processing results, including switch response codes.
- /ERROR Folder – Used by Batchgate to return files that failed validation, along with the corresponding response codes
This secure file exchange mechanism ensures the reliable and protected transmission of payment-related data between the corporate's ERP system and the Batchgate service.
File Formats
/IN Folder
This is the SFTP directory location where the corporate is required to upload its generated payment schedule for processing. All payment files should be dropped into this designated folder to enable the Batchgate service to pick up and process the transactions.
| Row | Record Type | Format | Description |
|---|---|---|---|
| 1 | Batch Record | {Batch_Reference, Batch_Description, ,Is_Single_Debit,Terminal_ID} | Batch header information |
| 2 | Source Account Record | {SECURE_DATA,SOURCE_ACCOUNT NUMBER,SOURCE_ACCOUNT_TYPE , BANK_CBN_CODE,ENCRYPTED_PIN ,MAC_DATA} | Secure card data |
| 3 to n-1 | Beneficiary Transaction Record | {PAYMENT_REF,AMOUNT,Narration ,BENEFICIARY_CODE, BENEFICIARY_EMAIL,BANK_CBN_CODE ,BENEFICIARY_ACCOUNT, BENEFICIARY_ACCOUNT_TYPE, IS_PREPAID_CARD_LOAD,CURRENCY_CODE ,BENEFICIARY_NAME, BENEFICIARY_PHONE_NUMBER} | Consists of payment information up until the second to the last row. |
/OUT Folder
This is the SFTP directory location where Batchgate returns the processing outcome for submitted payment schedules. All switch response codes for processed payments will be generated and made available in this designated folder, enabling the corporate to retrieve and reconcile the results of their transactions.
| Row | Format | Description |
|---|---|---|
| 1 | {Batch_Reference,Batch_Description, Is_Single_Debit,Terminal_ID,RESPONSE_CODE} | Batch header information |
| 3 to n-1 | {PAYMENT_REF,AMOUNT,BENEFICIARY_NAME, BANK_CBN_CODE,BENEFICIARY_ACCOUNT,BENEFICIARY_ACCOUNT_TYPE, IS_PREPAIDCARDLOAD,SWITCH_RESPONSE} | Consists of payment information up until the second to the last row. |
Switch ResponseClick here to get the list of switch response codes.
/ERROR Folder
This is the SFTP directory location where Batchgate returns validation feedback for submitted payment files that fail header validation checks during processing. All applicable response codes and error details for files that do not meet the required header format or validation criteria will be generated and made available in this designated folder, enabling the corporate to review, correct, and resubmit the affected files.
| Row | Format | Description |
|---|---|---|
| 1 | {Batch_Reference,Batch_Description, Terminal_ID,Is_Single_Debit,RESPONSE_CODE} | Batch header information |
| 2 | {SECURE_DATA,SOURCE_ACCOUNT_NUMBER, SOURCE_ACCOUNT_TYPE,BANK_CBN_CODE, ENCRYPTED_PIN,MAC_DATA} | Secure card data |
| 3 to n-1 | {PAYMENT_REF,AMOUNT,BENEFICIARY_CODE, BENEFICIARY_EMAIL,BENEFICIARY_ACCOUNT, BENEFICIARY_ACCOUNT_TYPE,IS_PREPAIDLOAD,CURRENCY_CODE, BENEFICIARY_NAME,BENEFICIARY_PHONE_NUMBER} | Consists of payment information up until the second to the last row. |
Response CodeClick here to get the list of file validation response codes.
Updated 18 minutes ago
