Bill file

No.

Field

Description

1

Serial number of the payment request

MANDATORY String(64)

The unique serial number for payment request

2

partner_id

MANDATORY String(16)

The tax refund company ID agreed between the company and Alipay, not the factoring partner_id.

3

Currency

OPTIONAL String(3)

CNY 

4

total request amount

MANDATORY Number(12,2)

The unit is yuan and is accurate to the smallest unit of the currency.

Note: Total request amount = Total refund amount - Pre-auth amount + Pre-auth refund amount.

5

success transactions

MANDATORY String

The number of successful tax refund transactions

6

success amount

MANDATORY Number(12,2)

The successfully tax refund amount, which is accurate to the smallest unit of currency.

7

failed transactions

MANDATORY String

The number of failed tax refund transactions

8

failed amount

MANDATORY Number(12,2)

The amount of failed tax refund. The unit is yuan and is accurate to the smallest unit of the currency.

9

pre-auth transactions

MANDATORY String

Must be an integer that is greater than 0.

10

pre-auth amount

OPTIONAL Number(12,2)

The unit is yuan and is accurate to the smallest unit of the currency. If no value exists, then 0.00 will be filled.

11

Pre-auth refund transactions

MANDATORY String

Must be an integer that is greater than 0.

12

Pre-auth refund amount

OPTIONAL Number(12,2)

The unit is yuan and is accurate to the smallest unit of the currency. If no value exists, then 0.00 will be filled.

13

Billing date

MANDATORY String(24)

The billing date. The format is yyyy-mm-dd hh:mm:ss.

14

Due date

MANDATORY String(24)

The due date. The format is yyyy-mm-dd hh:mm:ss.

No.

Field

Description

1

out_transaction_no

MANDATORY String(64)

The unique serial number of the tax refund order in the tax refund company.

Note: in the advance refund V2.0(zhima+huabei) case, this field is out_tax_refund_no when you send to Alipay through alipay.overseas.tax.advanced.create.

2

Tax_refund_no

MANDATORY String(64)

The unique serial number of the tax refund order in Alipay.

Note: in the advance refund V2.0(zhima+huabei) case, this field is tax_refund_no when you send to Alipay through alipay.overseas.tax.advanced.create.

3

Pre-auth_transaction_no

OPTIONAL String(64)

This field is not required in a non-escrow tax refund.

Note: In the advance tax refund V2.0 (zhima and huabei) case, this field does not exist.

4

amount

MANDATORY Number(12,2)

The amount is accurate to the smallest unit of currency. The unit is yuan.

5

mobile

MANDATORY String(16)

Chinese mobile phone number with 11 figures

6

passport

OPTIONAL String(32)

The passport number of the customer

7

name

OPTIONAL String(100)

The name stated on the customer's passport

8

nationality

OPTIONAL String(32)

The nationality stated on the customer's passport

9

Status/ process result

OPTIONAL String(1)

The process result. Possible values include:

• T: Success
• F: Failure

10

Remarks

OPTIONAL String(128)

When the process result is F, provide the error code in this field.