Bill files
After the user receives the tax refund amount, Alipay generates the account statement in the file form regularly and uploads it to the Alipay SFTP server according to the agreement with the tax refund company. Alipay system sends the notification of the payment request to the tax refund company.
Bill file obtained from SFTP
After the bill 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 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 Note: Use the upload file date. | A fixed value: "bill" | .txt | 2088002007018916_20131003_bill.txt |
File contents
A bill file might contain the following fields:
| No. | Field | Description |
Summarizing information format (the first line of files) | ||
1 | Serial number of request for payment | MANDATORY String(64) The unique serial number of account statement for payment request. |
2 | Tax Reimbursement Company shall pay ID agreed between the Company and Alipay | MANDATORY String(16) The payment ID agreed between the tax refund company and Alipay. |
3 | Currency of tax reimbursement | OPTIONAL String(3) Only CNY is supported now. |
4 | Total number of successful tax reimbursement | MANDATORY String The total number of successful tax reimbursement |
5 | Amount of money of successful tax reimbursement | MANDATORY Number(12,2) The tax refund amount that is accurate to two decimal places. |
6 | Total number of failure tax reimbursement | MANDATORY String The total number of failed tax reimbursement |
7 | Amount of money of failure tax reimbursement | MANDATORY Number(12,2) The tax refund amount that is accurate to two digits after the decimal point. |
8 | Date created of account statement | MANDATORY String(24) Date of account statement creation. The format is yyyy-mm-dd hh:mm:ss. |
9 | Latest date of payment of account statement | MANDATORY String(24) Latest payment date of account statement. The format is yyyy-mm-dd hh:mm:ss. |
Information in details | ||
1 | Serial number of business of tax reimbursement institute | MANDATORY String(64) The unique business serial number of tax refund institute. |
2 | Unique Alipay serial number | MANDATORY String(16) The unique Alipay serial number of tax refund data. |
3 | Amount of tax reimbursement | MANDATORY Number(8,2) The tax refund amount that is accurate to two decimal places. |
4 | Binding Alipay mobile phone number | MANDATORY String(16) The Chinese mainland mobile phone number with digits. |
5 | Passport number | MANDATORY String(32) The customer's passport number. |
6 | Name | MANDATORY String(100) The customer's name in the passport. |
7 | Nationality | MANDATORY String(32) The customer's nationality in the passport. |
8 | Treatment results | OPTIONAL String(1) The treatment result. Possible values include:
|
9 | Process information remarks | MANDATORY String(128) When the failure description and treatment result is F, the remark will be an error code. |
Sample
132323232|2088002007018916|CNY|1|100.00|1|100.01|2013-9-25 12:00:00|2013-10-31 00:00:00
1001|2013092011111111|100.00 |13858012559|CHN20114|GONGLEI|CHN|T|
1002|2013092011111112|100.01|13858012558|CHN20115|WANGCY|CHN|F| ILLEGAL_ACCOUNTNotification of the payment request
Alipay generates files of the payment request and uploads it to the SFTP server to inform the tax reimbursement company. 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 ID for a specific notification, which is used by the tax refund company to verify the notification. |
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 | |
bill_no String(16) | The unique serial number of account statement of the payment request. |
file_name String(64) | File name |