About Alipay

General information about Alipay

China is the second largest market worldwide for online payments with annual sales of over 100 billion US Dollars and it offers the greatest growth potential for eCommerce. Alipay is a leading local Payment Service Provider (PSP) with a popular E-Wallet for online payments. Alipay supports transactions within China as well as cross-border transactions (CrossBorder) to foreign merchants, which are directly billed in one of the supported currencies.

Alipay Spot Payment is a payment variant for Alipay customers who also want to use their Alipay account in store. The checkout system scans a barcode generated by the Alipay App from the customer's mobile phone and then calls an Alipay online interface via . Alipay Spot Payment is available only for cross-border partners.


Logo

Info

Customers and merchants can send and receive payments with the E-Wallet from China’s leading online payment system. Alipay has over 800 million registered users and in 2014 it processed over 100 million online payments per day.

TypePayments by eWallet


Further information you will find also on the webpage of Alipay (https://intl.alipay.com/).

Process flow chart

On this page


interface


Payment with Alipay over form interface

To make an Alipay payment via PPRO over a form, please use the following URL:

alipay.aspx

 

Key

Format

CND

Description

Beschreibung

Currency

A3

M

Currency, three digits DIN / ISO 4217. Only EUR, GBP, USD allowed. Please find an overview here: A1 Currency table EN

Währung, drei Zeichen DIN / ISO 4217. Nur EUR, GBP, USD zulässig. Hier eine Übersicht: A1 Währungstabelle

Key

Format

CND

Description

Beschreibung

OrderDesc

ans..768

M

Description of purchased goods, unit prices etc.

Beschreibung der gekauften Waren, Einzelpreise etc.

Key

Format

CND

Description

Beschreibung
Languagea2O2-letter language code (e.g.. de) that should be preferred when presenting payment pages to the consumer2-stelliger Sprachcode (z.B. de), der für die Zahlungsseiten für den Kunden bevorzugt werden soll

AccOwner

ans3..50

M

Name of account holder

Name des Kontoinhabers
Device

a6

O

When submitting “Mobile” the mobile version of Alipay is called instead of the desktop versionBei Übergabe von „Mobile“ wird statt der Desktop-Version die Mobil-Version von Alipay aufgerufen
AddrCountryCode

a2

O

Country code for the account holder’s invoicing address, 2 characters according to ISO 3166. Only CN allowed, defined within the code.Ländercode der Rechnungsadresse des Kontoinhabers zweistellig gemäß ISO 3166. Nur CN zulässig, im Code festgelegt.
HotelNameans..128CName of the hotel for which the reservation is for. Mandatory in case the merchant’s business type is Hotel.Name des Hotels, für das die Reservierung gamacht wurde. Obligatorisch, wenn die Geschäftsart des Händlers Hotel ist.
CheckInTimeans..128C

Date of the check-in expressed in GMT+8, in format: YYYY-MM-DD. Mandatory in case the merchant’s business type is Hotel.

Example: 2020-01-22

In case of multiple entries, they should be separated by a ‘|’ .

Example: 2020-01-22|2020-02-10

Datum des Eincheckens in GMT+8 im Format: JJJJ-MM-TT. Obligatorisch, wenn die Geschäftsart des Händlers Hotel ist.

Beispiel: 2020-01-22

Mehrere Einträge sollten mit einem ‘|’ getrennt werden.

Beispiel: 2020-01-22|020-02-10

CheckOutTimeans..128C

Date of the check-out expressed in GMT+8, in format: YYYY-MM-DD. Mandatory in case the merchant’s business type is Hotel.

Example: 2020-01-25

In case of multiple entries, they should be separated by a ‘|’’.

Example: 2020-01-25|2020-02-14

Datum des Auscheckens in GMT+8 im Format: JJJJ-MM-TT. Obligatorisch, wenn die Geschäftsart des Händlers Hotel ist.

Beispiel: 2020-01-25

Mehrere Einträge sollten mit einem ‘|’ getrennt werden.

Beispiel: 2020-01-25|2020-02-14

OrderDesc2ans..400CBase64 encoded JSON object with description of purchased products and their quantityBase64-codiertes JSON-Objekt mit Beschreibung und Menge der gekauften Produkte

Parameters for payments with Alipay


Key

Format

CND

Description

Beschreibung

TransactionID

an..20

O

Unique transaction number from PPRO

Eindeutige Transaktionsnummer bei PPRO

Return parameters for URLSuccess, URLFailure and URLNotify with Alipay


Credit with reference

credit.aspx

 

Parameters for credit payments with Alipay via socket connection

 

Key

Format

CND

Description

Beschreibung
ErrorTextans..256OC

Detailed PPRO error message

Detaillierte PPRO-Fehlermeldung

Response parameters for credit payments with Alipay via socket connection

 


Batch processing via the interface

This section describes the parameters which must be transferred within the data set (Record) for executing credits with Alipay, which can be found within the response file about the payment status.

Following table gives an overview of all batch versions that are possible for a specific action and their specialities:

Action

Version

Description

Beschreibung

Credit

1.0 / 2.0

Standard version without return of parameter Code

Standardversion ohne Rückgabe von Parameter Code


1.x / 2.x

with RefNr (valid for all versions other than 1.0)

mit RefNr (gilt für alle Versionen außer 1.0)

Description of the possible batch versions


The structure for an Alipay payment within a Batch file to be submitted is as follows:

HEAD,<MerchantID>,<Date>,<Version>
Alipay,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
FOOT,<CountRecords>,<SumAmount>


Example for Master MID function:

HEAD,[Master]MerchantID,Date,2.x
Type,Action,[Slave]MID,Amount,Currency,TransID,Data (depends on Action)
FOOT,CountRecords,SumAmount


Key

Format

CND

Description

Beschreibung

Type

a..11

M

HEAD for Header, FOOT for Footer, Alipay for Alipay

HEAD für Header, FOOT für Footer, Alipay für Alipay

Action

a..20

M

The parameter Action defines the type of transaction:

Credit

Der Action-Parameter definiert die Art der Transaktion:

Credit (Gutschrift)

Description of fields within the record for Batch files

 

The record area within the response file for Batch transactions looks as follows:

HEAD,<MerchantID>,<Date>,<Version>
Alipay,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>
FOOT,<CountRecords>,<SumAmount>


Key

Format

CND

Description

Beschreibung

Action

a..20

M

The parameter Action defines the type of transaction: Credit

Der Action-Parameter definiert die Art der Transaktion: Credit (Gutschrift)

Description of result parameters within the record for Batch files


JSON object OrderDesc2

Scheme

{
    "$schema": "http://json-schema.org/draft-06/schema#",
    "type": "array",
    "items": {
        "$ref": "#/definitions/GoodsInfoElement"
    },
    "definitions": {
        "GoodsInfoElement": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
                "itemDescription": {
                    "type": "string"
                },
                "number": {
                    "type": "integer"
                }
            },
            "required": [
                "itemDescription",
                "number"
            ],
            "title": "GoodsInfoElement"
        }
    }
}

Example

[{
     "itemDescription": "Book",
     "number": 3
}, {
     "itemDescription": "Movie",
     "number": 2
}
]