Alipay+ DocsAlipay+ Docs

Overview

Alipay+ provides a set of reconciliation reports to help the Mobile Payment Providers (MPPs) reconcile the transactions and settlements. MPPs can download and use these reports to perform reconciliation.

Basic concepts

This section introduces the basic concepts used in this document.

Clearing

Clearing means the process of transmitting, aggregating, and netting transaction data and relevant fees for payments and refunds, prior to settlement. Clearing results are concluded in clearing reports. For more information about the clearing reports, see Reports.

Settlement

Settlement means the process of calculating the net settlement amount with respect to each Partner in Settlement Reports and then the relevant party completing the settlement funds transfer on the settlement day for all payments and refunds (and any other amounts) that are cleared during a settlement cycle. For more information about the settlement reports, see Reports.

When discrepancies exist, Alipay+ first completes the settlement process before initiating the discrepancy resolution process.

Exchange rate

When the transaction currency and the settlement currency differ, the exchange rate used for the exchange from the transaction amount to the settlement amount is the same as that used for the original transaction. The Settlement Report does not contain the exchange rate. The exchange rate is only contained in the API requests of the original transaction:

  • For payments: the value of the paymentQuote parameter in the pay/userInitiatedPay API.
  • For refunds: the value of the refundQuote parameter in the refund API.

Fees

There are two types of fees:

  • Interchange fee: also known as interpartner fee, the fee that the ACQP pays to the MPP for a transaction.
  • Service fee: the fee that the MPP pays to Alipay+ for a transaction.

The MPP charges interchange fees from the ACQP and is charged by Alipay+ for service fees.

The following figure shows an example of the service fee and the interchange fee.

image.png

In the example:

  • Payment: The user pays 1000 SEK for a transaction.
  • Service fee: Alipay+ charges a 4 SEK service fee from the MPP and a 0.4 USD service fee from the ACQP.
  • Interchange fee: The MPP charges a 13 SEK interchange fee from the ACQP. Alipay+ collects the interchange fee from the ACQP on behalf of the MPP and then transfers it to the MPP.

As a result, for this transaction:

  • The MPP settles to Alipay+: 1000 + 4 - 13 = 991 SEK
  • Alipay+ settles to the ACQP: 100 - 0.4 - 1.3 = 98.3 USD

Note: The fee rates in the example above are for reference only. The actual fee rate is determined by your contract with Alipay+.

Cycles

The clearing cycle and the settlement cycle are defined in UTC+8 time.

Clearing cycle

Alipay+ performs clearing with MPPs every T+1 day, of T day's transactions from 00:00:00 to 23:59:59, UTC+8, including holidays.

Settlement cycle

Settlement cycle is the frequency at which the MPP settles funds to Alipay+ for all the payments and refunds during a clearing cycle. By default, the settlement cycle is every T+1 day (the settlement day, and must be a Local Business Day). The length of an actual settlement cycle can vary.

Even when the settlement cycle is T+1, a settlement cycle can contain multiple clearing cycles when:

  • A settlement cycle contains the previous clearing cycles on holidays.
  • Some previous clearing cycles might have no funds being credited to Alipay+ and no settlement is done.

Local Business Day

Local Business Day means, in respect of an MPP, a day on which all banks are open for general banking business in the business territory of that MPP, excluding a Saturday, Sunday, or public holiday in that business territory.

Reports

This section provides information on how to select and download reports.

Reports and reconciliation tasks

Reconciliation reports consist of the clearing reports and the Settlement Report. The following tables contain basic information about each report and what tasks each report is designed to perform:

Clearing reports

Name

Description

Tasks

Transaction Detail Report

Transaction Detail Report specifies the transaction details for payments and refunds that are cleared during a clearing cycle and are to be settled in a certain currency. The detailed information includes the transaction count, type, time, amount, transaction ID, the ID of the involved parties, and the fees of each transaction.

Used to check the transaction amount and settlement amount of each transaction that is cleared during the clearing cycle and to be settled in a certain currency.

Fee Report

Fee Report summarizes the fee totals for transactions that are cleared during a clearing cycle and are to be settled in a certain currency. Also, fee details such as the amount, currency, type, time of each fee, and the ID of the related transactions are included.

Used to check the fee amount of each transaction that is cleared during the clearing cycle and to be settled in a certain currency.

Transaction Summary Report

Transaction Summary Report summarizes the total amount of transactions that were cleared during a clearing cycle and are to be settled in a certain currency.

If there is only one clearing cycle in the settlement cycle, the total settlement amount in the Transaction Summary Report and the one in the Settlement Report are the same.

Used to check the total settlement amount of all the transactions that are cleared during the clearing cycle and to be settled in a certain currency.

Generation schedule

All clearing reports are generated at 08:00 AM UTC+8 on T+1 day on a daily basis, including holidays.

Settlement Report

Name

Description

Tasks

Settlement Report

Settlement Report states the net settlement amount in a certain currency payable or receivable by the MPP for the settlement cycle.

Also, the net settlement amount, net transaction amount, and the respective currencies for every clearing cycle within the settlement cycle are included.

Used to check the total settlement amount of all the transactions that are cleared during the settlement cycle and are settled in a certain currency.

Generation schedule

Settlement Reports are generated at 08:00 AM UTC+8 on the agreed settlement date (T+1 by default). Only on Local Business Days.

Notes:

  • Reports generated by Alipay+ use Line Feed (LF) as the line break.
  • All amount values in the reports are provided in the smallest unit of the corresponding currency without decimal places. For example, if the currency is USD and the amount is $1.00, the value of this parameter is 100; if the currency is JPY and the amount is ¥1, the value of this parameter is 1.

For more information about the reports, such as samples, report structures, and naming conventions, see:

Download reports

You can download reports from the SFTP server or Alipay+ Partner Workspace. For more information on how to download reports, see Download reports.

How to perform reconciliation

You need to record your transactions and reconcile your records with the reports sent by Alipay+. For more information about this topic, see Perform reconciliation.

Explore more

This section introduces information for AlipayCN and how to handle exceptional cases.

Notes for AlipayCN

The reports and the settlement with AlipayCN differ from other ACQPs.

  • Another set of reports is dedicated to AlipayCN only. The file structure/directory/filename rules are the same, only the participantAgreementId parameter in the filename is different. In the SFTP, the reports are stored in the same directory. For the file structure/directory/filename rules of each report, see the Reports topics.
  • The MPP sends the settlement funds to Alipay+ separately for AlipayCN transactions. The settlement calendar and minimum settlement amount are different, following AlipayCN settlement generation rules. By default, AlipayCN also settles on every T+1 day.

Handle exceptional cases

You might encounter problems when performing reconciliation. Handle exceptional cases presents typical exceptional cases that might be encountered and the corresponding resolutions.