Alipay

This guide explains how to process Alipay payments with our SDK.

Configuration

In order to use Alipay your should register merchant account. You can find detailed instructions in the Alipay guide.

Adding Alipay to your app must be done in one of two ways, depending on whether you are using the Ready-to-Use UI or the SDK & Your Own UI. These two ways are covered in the sections below. Please follow the instructions relevant to the approach you have chosen.

iOS

Ready-to-Use UI

If you are using our ready-to-use checkout screens

First of all import our Alipay SDK:

Drag and drop OPPWAMobile+Alipay.framework to the project.
Make sure the framework is added to the Embedded Binaries as well.

Then configure Alipay in OPPCheckoutSettings along with other customizations.

Set your custom URL scheme:

OPPCheckoutSettings *checkoutSettings = [[OPPCheckoutSettings alloc] init];
checkoutSettings.schemeURL = @"com.companyname.appname.payments";

let checkoutSettings = OPPCheckoutSettings()
checkoutSettings.schemeURL = "com.companyname.appname.payments"

Make sure Alipay is included to the payment brand list:

checkoutSettings.paymentBrands = @[@"ALIPAY", ... ];

checkoutSettings.paymentBrands = ["ALIPAY", ...]

And you are done!

SDK & Your Own UI

If you are using our SDK & Your Own UI then there is a little more work to be done, but it is still easy to add. There are two options for accepting Alipay payments:

Accept Alipay payment as usual asynchronous transaction. For this reason, please see this guide.
Accept Alipay payment using their native SDK. This case will be describe bellow.

Create OPPPaymentParams with the checkout id and submit a transaction. See below the full Alipay flow.

NSError *error = nil;
OPPPaymentParams *paymentParams = [OPPPaymentParams paymentParamsWithCheckoutID:checkoutID paymentBrand:@"ALIPAY" error:&error];
if (error) {
    // See error.code (OPPErrorCode) and error.localizedDescription to identify the reason of failure.
} else {
    OPPTransaction *transaction = [OPPTransaction transactionWithPaymentParams:paymentParams];
    [self.provider submitTransaction:transaction completionHandler:^(OPPTransaction * _Nonnull transaction, NSError * _Nullable error) {
        if (error) {
            // Handle the error.
        } else {
            // Use transaction.alipaySignedOrderInfo for authorization transaction through Alipay SDK
        }
    }];
}

do {
    let paymentParams = try OPPPaymentParams(checkoutID: checkoutID, paymentBrand: "ALIPAY")
    let transaction = OPPTransaction(paymentParams: paymentParams)
    provider.submitTransaction(transaction) { (transaction, error) in
        if (error != nil) {
            // Handle the error.
        } else {
            // Use transaction.alipaySignedOrderInfo for authorization transaction through Alipay SDK
        }
    } catch let error as NSError {
        // See error.code (OPPErrorCode) and error.localizedDescription to identify the reason of failure.
    }

Call the native method from Alipay SDK with the value alipaySignedOrderInfo property from the transaction which your received in the callback:

[[AlipaySDK defaultService] payOrder:transaction.alipaySignedOrderInfo fromScheme:@"com.companyname.appname.payments" callback:^(NSDictionary *resultDic) {
    // Sent request to your server to obtain transaction status
}];

AlipaySDK.defaultService().payOrder(transaction.alipaySignedOrderInfo, fromScheme: "com.companyname.appname.payments") { (result) in
    // Sent request to your server to obtain transaction status
}

Alipay may return the result of the transaction directly in the completion block or as Asynchronous notification to App delegate.

Android

Import oppwa.mobile.alipay.aar into your project (File > New > New Module > Import .JAR/.AAR Package).
Then, reference it from your application (File > Project Structure > Dependencies > Add Module Dependency).

Ready-to-Use UI

If you are using our ready-to-use checkout screens, configure Alipay in CheckoutSettings along with other customizations.

Simple add the Alipay to the payment brands:

Set<String> paymentBrands = new LinkedHashSet<String>();

paymentBrands.add("ALIPAY");

CheckoutSettings checkoutSettings = new CheckoutSettings(checkoutId, paymentBrands);

And you are done!

SDK & Your Own UI

If you are using our SDK & Your Own UI then there is a little more work to be done, but it is still easy to add. There are two options for accepting Alipay payments. Create PaymentParams with the checkout id and submit a transaction:

PaymentParams paymentParams = new PaymentParams(checkoutId, "ALIPAY");
Transaction transaction = new Transaction(paymentParams);

/* use IProviderBinder to interact with service and submit transaction */
binder.submitTransaction(transaction);

Call the native method from Alipay SDK with the value alipaySignedOrderInfo property from the transaction which your received in the callback:

PayTask payTask = new PayTask(YOUR_ACTIVITY.this);
String result = payTask.pay(transaction.getAlipaySignedOrderInfo());

/* process the result */

NOTE: This method must be called from a different thread.