Copyright © 2016 W3C® (MIT, ERCIM, Keio, Beihang). W3C liability, trademark and permissive document license rules apply.
The Alipay payment method specification describes the data formats used by the PaymentRequest API [PAYMENTREQUESTAPI] to support payment by Alipay.
This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at https://www.w3.org/TR/.
This document was published by the Web Payments Working Group as a Working Draft.
Comments regarding this document are welcome. Please send them to public-payments-wg@w3.org (archives).
Publication as a Working Draft does not imply endorsement by the W3C Membership. This is a draft document and may be updated, replaced or obsoleted by other documents at any time. It is inappropriate to cite this document as other than work in progress.
This document was produced by a group operating under the W3C Patent Policy. The group does not expect this document to become a W3C Recommendation. W3C maintains a public list of any patent disclosures made in connection with the deliverables of the group; that page also includes instructions for disclosing a patent. An individual who has actual knowledge of a patent which the individual believes contains Essential Claim(s) must disclose the information in accordance with section 6 of the W3C Patent Policy.
This document is governed by the 1 March 2019 W3C Process Document.
This specification is a Alipay Payment Method Specification used by the PaymentRequest API [PAYMENTREQUESTAPI] to support payment by Alipay. It is intended to provide compatibility for merchants who currently request card details from customers to ease adoption of the PaymentRequest API.
In the future, merchants should favor payment methods that provide a tokenized response.
This specification relies on several other underlying specifications.
The following payment method identifier strings are supported by the Alipay data formats.
| Identifier String | Description |
|---|---|
| alipay | Alipay |
This section describes payment method specific data that is supplied as part of the data
argument to the PaymentRequest constructor.
The following is the payment method specific data used by the PaymentRequest constructor when processing Alipay Payment methods.
WebIDL dictionaryPaymentMethodSpecificData{ required DOMStringservice; required DOMStringpartner; required DOMString_input_charset; required DOMStringsign_type; required DOMStringsign; required DOMStringnotify_url; DOMStringout_trade_no; DOMStringsubject; DOMStringpayment_type; DOMStringseller_id; DOMStringtotal_fee; DOMStringbody; DOMStringgoods_type; DOMStringit_b_pay; };
The PaymentMethodSpecificData dictionary contains the following fields:
serviceservice field contains interface name which is a Fixed value.partnerpartner field contains the merchant's account.input_charset_input_charset field contains the encoding type of merchant’s website, default value is utf-8.sign_typesign_type field contains the signature type.signsign field contains the signature content.notify_urlnotify_url field contains the asynchronous notification URL.out_trade_noout_trade_no field contains the unique order number in merchant website.subjectsubject contains the key word for the merchandise,transaction, order etc.payment_typepayment_type field contains the payment type.seller_idseller_id field contains the seller's account.total_feetotal_fee field contains the total amount of an order (RMB). Value range is [0.01, 100000000.00].bodybody field contains the description information of one transaction.goods_typegoods_type field contains the merchandise type. 1: physical; 0: virtual.
it_b_payit_b_pay field contains the time out value for unfinished transaction.The AlipayResponse dictionary contains the response from the
PaymentRequest API when a user accepts payment with a Alipay payment method.
WebIDL dictionaryAlipayPaymentResponse{ required DOMStringsuccess; required DOMStringnotify_id; required DOMStringnotify_time; required DOMStringnotify_type; required DOMStringsign_type; required DOMStringsign; DOMStringout_trade_no; DOMStringsubject; DOMStringpayment_type; DOMStringtrade_no; DOMStringtrade_status; DOMStringseller_id; DOMStringseller_email; DOMStringbuyer_id; DOMStringbuyer_email; DOMStringtotal_fee; DOMStringquantity; DOMStringprice; DOMStringbody; DOMStringgmt_create; DOMStringgmt_payment; DOMStringrefund_status; DOMStringgmt_refund; };
The AlipayPaymentResponse dictionary contains the following fields:
successsuccess field contains indication whether the transaction is successful. notify_idnotify_id field contains the notification ID. notify_timenotify_time field contains the notification time. notify_typenotify_type field contains the notification type. sign_typesign_typefield contains the signature type.signsignfield contains the signature content.out_trade_noout_trade_no field contains the order number in merchant website.subjectsubject field contains the key word for the merchandise,transaction, order etc .payment_typepaymentfield contains the payment_type . trade_notrade_nofield contains the order number of the transaction. trade_statustrade_status field contains the trade status. seller_idseller_id field contains seller's account.seller_emailseller_email field contains the seller's email.buyer_idbuyer_id field contains the buyer ID to indentify the buyer's account.buyer_emailbuyer_email field contains the buyer's email.total_feetotal_fee field contains total amount of an order (RMB).quantityquantity field contains the quantity of the merchandise. priceprice field contains the price of merchandise.bodybody field contains description of the merchandise.gmt_creategmt_create field contains the time of the creation of the transaction.gmt_paymentgmt_payment field contains time of the payment.refund_statusrefund_status field contains the status of refund.gmt_refundgmt_refund field contains the time of refund.