Alipay - Buckaroo development portal

General

The Alipay service supports two actions: Pay and Refund.

Pay

The Pay action can be used to perform a payment.

View in playground

Request

JSON gateway request

UseMobileView

string

Required

Boolean: true or false. It is important to identify if the consumer is on a mobile device or not. If yes, then send value true. This will enable the Alipay app to be opened on the consumer's mobile device. If not, then send value false. The consumer will then be shown a QR code to scan.

 JSON 
								copy
								{
   "Currency": "EUR",
   "AmountDebit": 0.01,
   "Invoice": "testinvoice 1234",
   "Services": {
      "ServiceList": [
         {
            "Name": "Alipay",
            "Action": "Pay",
            "Parameters": [
               {
                  "Name": "UseMobileView",
                  "Value": "true"
               }
            ]
         }
      ]
   }
}
							

Response 200 Status: Ok 400 Status: Access denied 500 Status: Bad request

JSON gateway response

The consumer needs to be redirected to the RedirectURL provided in the response. From there either the Alipay app will be initiated on the consumer's device or a QR code will be shown, depending on the value given for UseMobileView.

 JSON 
								copy
								{
   "Key": "A1813E0EC8D04B0788515B511A9A7xxx",
   "Status": {
      "Code": {
         "Code": 791,
         "Description": "Pending processing"
      },
      "SubCode": {
         "Code": "S002",
         "Description": "An additional action is required: Redirect to Alipay."
      },
      "DateTime": "2019-08-07T12:35:26"
   },
   "RequiredAction": {
      "RedirectURL": "https://testcheckout.buckaroo.nl/html/redirect.ashx?r=2AB53A4132A14E508D3CB98B47E72xxx",
      "RequestedInformation": null,
      "PayRemainderDetails": null,
      "Name": "Redirect",
      "TypeDeprecated": 0
   },
   "Services": null,
   "CustomParameters": null,
   "AdditionalParameters": null,
   "RequestErrors": null,
   "Invoice": "testinvoice 1234",
   "ServiceCode": "Alipay",
   "IsTest": true,
   "Currency": "EUR",
   "AmountDebit": 0.01,
   "TransactionType": "C052",
   "MutationType": 1,
   "RelatedTransactions": null,
   "ConsumerMessage": null,
   "Order": null,
   "IssuingCountry": null,
   "StartRecurrent": false,
   "Recurring": false,
   "CustomerName": null,
   "PayerHash": null,
   "PaymentKey": "CC60B93D3F3A444E9FE3AF6C2645xxx"
}
							

Push

JSON push response

After successful completion of the payment by the consumer, a push response will follow with the final transaction status.

 JSON 
								copy
								{
   "Transaction": {
      "Key": "A1813E0EC8D04B0788515B511A9A7xxx",
      "Invoice": "Testinvoice 1234",
      "ServiceCode": "Alipay",
      "Status": {
         "Code": {
            "Code": 190,
            "Description": "Success"
         },
         "SubCode": {
            "Code": "S990",
            "Description": "The request was successful."
         },
         "DateTime": "2019-08-07T12:35:34"
      },
      "IsTest": true,
      "Order": null,
      "Currency": "EUR",
      "AmountDebit": 0.01,
      "TransactionType": "C052",
      "Services": null,
      "CustomParameters": null,
      "AdditionalParameters": null,
      "MutationType": 1,
      "RelatedTransactions": null,
      "IsCancelable": false,
      "IssuingCountry": null,
      "StartRecurrent": false,
      "Recurring": false,
      "CustomerName": null,
      "PayerHash": null,
      "PaymentKey": "CC60B93D3F3A444E9FE3AF6C26450xxx"
   }
}
							

Refund

This action can be used to perform a refund on a Alipay transaction.