Remit files
After the tax reimbursement company pays Alipay, the payment information and corresponding paid account statement information will be sent to Alipay. The tax reimbursement company must then upload the remittance files to Alipay's SFTP server. Alipay will obtain the latest files from SFTP server regularly for parsing and upload the parsing results to SFTP server. Alipay will inform the tax reimbursement company of the treatment results at the same time.
Remit file obtained from SFTP
After the bill file is downloaded and your business team remit the funds to Alipay, you should upload the remit file on Alipay SFTP server.
After the remit file is uploaded, Alipay will inform you by your registration notify URL. If you need the notification, please provide the notify URL to Alipay Technical Support. The same notify URL must be used to receive notification of bill file.
The file name consists of different parts. See the following table for details:
Partner ID | Date | File Type | File Suffix | Sample |
A unique ID assigned by Alipay, which is agreed by tax reimbursement company and Alipay. | YYYYMMDD | A fixed value: "REMIT" | .txt | 2088002007018916_20131003_REMIT.txt |
File contents
The file name consists of different parts. See the following table for details.
| No. | Field | Description |
Summarizing information format (the first line of files) | ||
1 | Remittance serial number | MANDATORY String The remittance serial number of the tax refund institute. |
2 | Tax Reimbursement Company shall pay ID agreed between the Company and Alipay | MANDATORY String The payment ID agreed between the tax refund company and Alipay. |
3 | Remitter name | MANDATORY String(100) The remitter's name |
4 | Remittance account number | MANDATORY String(64) The remittance account number |
5 | Remittance currency | MANDATORY String(3) Only CNY is supported now. |
6 | Remittance aggregate amount | MANDATORY Number(12,2) The remittance aggregate amount that is accurate to two decimal places. |
7 | Corresponding account statement quantity of remittance | MANDATORY Corresponding account statement for quantity of remittance. The integer that is greater than 0. |
8 | Remittance date | MANDATORY String(24) The remittance date. The format is yyyy-mm-dd hh:mm:ss.
|
9 | Remittance remarks | OPTIONAL String(128) Remittance remarks |
Information in details | ||
1 | Serial number of request for payment | MANDATORY String The unique serial number of account statements for payment request. |
2 | Aggregate amount of account statements of request for payment | MANDATORY Number(12,2) The remittance aggregate amount that is accurate to two decimal places. |
Sample
0001|2088002007018916|TEST|662211112200001111|CNY|200.00|2|2013-10-05:12:00:00|TAX
132323232|100.00
132323233|100.00Remittance treatment
Alipay informs the tax refund company after the remittance file is successfully treated. Therefore, the merchant must designate an address that can accept Alipay's notification. The notification contents are as follows:
Parameter | Description |
| Basic parameter | |
notify_type String | The value is fixed as |
notify_id String(34) | The unique ID for notification to validate. |
notify_time Timestamp | The system notification time. The time is in GMT+8, and in a yyyy-mm-dd hh:mm:ss format. |
sign String | Sign value |
_input_charset String | The coding format agreed by both parties. Supported formats: uft-8, GBK, and gb2312. |
sign_type String | The sign type. MD5 is supported. |
| Business parameter | |
remit_no String | The remittance serial number of the tax refund company |
file_name String(64) | The remittance file name of the tax refund company |
file_parse_result String(1) | The treatment result. Possible values include:
|
file_parse_error_code String(64) | When the treatment result is F, there is error description and this field is not required. |