Payment Method Properties

Transaction flow

1. On the merchant checkout page, the consumer selects paying with Alipay.
2. The merchant sends a transaction request to Alipay.
3. If the consumer is paying from a desktop browser:
   1. The consumer is redirected to an Alipay page
   2. The page will display a QR code if the mobileview is not set to yes
   3. The consumer scans the QR code. Alternatively, they can log in to the Alipay website to make the payment.
4. If the consumer is paying from a mobile device:
   1. Alipay returns a payment link to the merchant's mobile website.
   2. The merchant's mobile website redirects the consumer to the Alipay in-app payment page.
   3. The consumer completes the payment in the Alipay app.

Merchant business type

There are certain specins that are only required when a partner has a determined merchant business type. The boarding team will confirm your merchant's business type during the onboarding process

Alipay Online Integration

Specific input parameters

For standard input parameters, see Input parameters for the TRANSACTION call.

Specific output parameters

For standard output parameters, see Output parameters for the TRANSACTION call.

Specific output parameters for the REFUND call

👍

Note

The refund uses the same exchange rate as the transaction. The total refund amount to be settled will be the same as the original total transaction amount that was settled. In the case of partial refunds, the refund amount will also be calculated with the same exchange rate, so the refund amount will never exceed the original amount.

TRANSACTION call input

tag=alipay
&txtype=TRANSACTION
&countrycode=CN
&currency=CNY
&amount=1055
&merchanttxid=mCYaU22CeZWh
&login=johndoe
&password=wXBrpVporFVjGO4R
&contractid=JOHNDOECONTRACT
&channel=testchannel
&merchantredirecturl=https%3A%2F%2Fmerchant.com%2Fwork%2Fppro2%2Flanding.php
&notificationurl=https%3A%2F%2Fmerchant.com%2Fwork%2Fppro2%2Fnotification.php
&specin.dynamicdescriptor=DynDescriptor
&accountholdername=John%20Doe
&returnmode=urlencodeext

TRANSACTION call output

REQUESTSTATUS=SUCCEEDED
&STATUS=SUCCEEDED
&TXID=844612929
&ERRMSG=
&CHANNEL=testchannel
&TAG=alipay
&REDIRECTSECRET=OTzp0pFUOGPMsW3KQSPhzrgHEa4h1DNw
&SPECOUT.OUTTRADENO=1111111
&SPECOUT.FXRATE=6.59430000
&SPECOUT.SETTLEMENTAMOUNT=15
&SPECOUT.SETTLEMENTCURRENCY=USD
&SPECOUT.CNYAMOUNT=97
&SPECOUT.ALIPAYCUSTOMSURL=https://svc-alipaycustoms.public.k8s.prod.ppro.com/alipay-customs?
sign=vVf3Eo8v1ytd%2BOf9Uy6UcZ8JppF1JCj1Wz%2Fa9r3yXo4%3D&txId=2020051422001336121451470631&amount=0.07
&SPECOUT.SRCCURRENCY=CNY
&SPECOUT.SRCAMOUNT=97

Additional Information

Notes on CNY Processing

All transactions processed in CNY are settled in USD or EUR. Alipay applies a foreign exchange rate per transaction and settles to us the converted amount in the predetermined settlement currency (USD or EUR). We also settle with you the converted amounts. This means you must track the foreign exchange rate per transaction for reconciliation purposes into the settlement currency (USD or EUR). We provide the foreign exchange rate between CNY and the settlement currency in SPECOUT.FXRATE.

Refunds are handled similarly. The SPECOUT.FXRATE parameter tracks the amount that will be deducted from your settlement. The consumer never pays any foreign exchange costs in none of the cases above. In both cases, you handle the cost through the USD or EUR settlement.

The table below shows the differences between CNY versus like-for-like processing currency.

Examples

The example used below shows an Alipay transaction with USD as the settlement currency.

Table 1. Transaction call example (only key parameters)

Table 2. Succeeded Transaction response example (only key parameters)

In the example above, the consumer will be billed CNY 10.00 and you will be settled USD 1.60.

Table 3. Refund call example (only key parameters)

Table 4. Succeeded Refund response example (only key parameters)

In the sample above, the consumer will be refunded CNY 10.00; you will be debited USD 1.60.

Settlement file examples

Table 5. Volume-per-transaction settlement file

Only the converted amount (USD or EUR) will show in this file.

Table 6. Volume-per-refund settlement file

Only the converted amount (USD or EUR) will show in this file.

Table 7. Aggregate settlement file

Only the converted amount (USD or EUR) will show in this file.