alipay.commerce.qrcode.modify
Call this interface to modify the QR code information.
Request
Service address
Environment | HTTPS request URL |
Production environment | |
Test environment |
Request parameters
Parameter | Description |
Basic parameter | |
service String Required | Interface name
|
partner String(16) Required | The partner ID that is assigned by Alipay to identify an Alipay account. The partner ID is composed of 16 digits and begins with 2088.
|
_input_charset String Required | The charset with which the request data is encoded. UTF-8, GBK, and GB2312 are supported.
|
sign_type String Required | Sign type. Only MD5 is supported. Use uppercase.
|
sign String Required | Sign value
|
timestamp String Required | The time when the merchant server sends request. The time is in GMT+8, and in a format of yyyy-MM-dd HH:mm:ss.By default, the request expires in 30 minutes.
|
notify_url URL(200) | The URL for receiving asynchronous notifications after the payment is completed.
|
Business parameter | |
biz_type String Required | Business type that is defined by Alipay, with a value of OVERSEASHOPQRCODE
|
qrcode String Required | The returned QR code value after the code is generated successfully.
|
biz_data String(2000) Required | Business data, which is in the JSON format. For more information, see biz_data.
|
biz_data
channel_fee
Parameter | Description |
type String Required | Channel fee type. The value can be FIXED to indicate the fee is a fixed amount or RATE to indicate the fee is calculated based on a certain percentage.
|
value String Required | 1. If the channel fee type is FIXED, the value range is [0, 5% of the original oder amount]. The unit of the value is HKD and is accurate to two decimal places. 2. If the channel fee type is RATE, the value range is [0, 0.05]. (In promotion season, the channel fee can be 0.)
|
Note:
Do not use the halfwidth quotation mark (") in parameter values.
Response
Synchronous response
Parameter | Description |
Basic parameter | |
is_success String Required | Indicates whether the request succeeds or not, with a value of T for success and F for failure. Note: a successful request does not mean the business is accepted and processed successfully.
|
sign_type String | Sign type
|
sign String | Sign value
|
error String | Error code that is returned when the request is not successful, to describe the request failure reason. If the request is successful, this field is not returned. For more information, see the Error Code section in this document.
|
Business parameter | |
qrcode String Required | QR code
|
Error codes
Business errors
Error code | Description |
AE_BARCODE_GENERAL_CODE_FAIL_AND_RETRY | QR code generation fails. You can try again later. |
AE_BARCODE_GENERAL_CODE_FAIL_AND_NOT_RETRY | QR code generation fails. You can try again later. |
ILLEGAL_ARGUMENT | Pamameter error. Check and try again. |
System errors
Error code | Description |
ILLEGAL_SIGN | Invalid signature |
ILLEGAL_DYN_MD5_KEY | Invalid dynamic key |
ILLEGAL_ENCRYPT | Invalid encryption |
ILLEGAL_ARGUMENT | Invalid argument |
ILLEGAL_SERVICE | Invalid service name |
ILLEGAL_USER | Invalid user ID |
ILLEGAL_PARTNER | Invalid partner ID |
ILLEGAL_EXTERFACE | Interface configure error. |
ILLEGAL_PARTNER_EXTERFACE | The partner ID does not have access privilege. |
ILLEGAL_SECURITY_PROFILE | The key is not available |
ILLEGAL_AGENT | Invalid Agent ID |
ILLEGAL_SIGN_TYPE | Invalid sign type |
ILLEGAL_CHARSET | Illegal character set |
HAS_NO_PRIVILEGE | No priviledge |
INVALID_CHARACTER_SET | Invalid character set. |
Samples
Request
https://intlmapi.alipay.com/gateway.do?service=alipay.commerce.qrcode.modify&partner=208xxxxxxxxx5500&_input_charset=UTF-8&sign_type=MD5¬ify_url=https%3A%2F%2Fwww.mikascoffee.com%2Fnotify×tamp=2019-09-10%2014%3A43%3A12&biz_type=OVERSEASHOPQRCODE&qrcode=https%3A%2F%2Fqr.alipay.com%2Focx09863drhqewuprmuzm68&biz_data=%7B%22secondary_merchant_industry%22%3A%225499%22%2C%22secondary_merchant_id%22%3A%221314520%22%2C%22secondary_merchant_name%22%3A%22Mika's%20coffee%20shop%22%2C%22store_id%22%3A%221993%22%2C%22store_name%22%3A%22Mika's%20coffee%20shop%22%2C%22trans_currency%22%3A%22HKD%22%2C%22currency%22%3A%22HKD%22%2C%22country_code%22%3A%22US%22%2C%22address%22%3A%223%20Old%20Concord%20Rd%2C%20Burlington%2C%20MA%2001804%E7%BE%8E%E5%9B%BD%22%2C%22notify_sign_type%22%3A%22RSA%22%2C%22notify_charset%22%3A%22UTF-8%22%7D&sign=9ea53d5a5d36b8e97bb086b5da64b76d
Response
Request succeeds:
<alipay>
<is_success>T</is_success>
<request>
<param name="partner">208xxxxxxxxx5500</param>
<param name="service">alipay.commerce.qrcode.modify</param>
<param name="_input_charset">UTF-8</param>
<param name="qrcode">https://qr.alipay.com/ocx09863drhqewuprmuzm68</param>
<param name="biz_type">OVERSEASHOPQRCODE</param>
<param name="sign">9ea53d5a5d36b8e97bb086b5da64b76d</param>
<param name="notify_url">https://www.mikascoffee.com/notify</param>
<param name="biz_data">
{"secondary_merchant_industry":"5499","secondary_merchant_id":"1314520","secondary_merchant_name":"Mika's coffee shop","store_id":"1993","store_name":"Mika's coffee shop","trans_currency":"HKD","currency":"HKD","country_code":"US","address":"3 Old Concord Rd, Burlington, MA 01804美国","notify_sign_type":"RSA","notify_charset":"UTF-8"}
</param>
<param name="sign_type">MD5</param>
<param name="timestamp">2019-09-10 14:43:12</param>
</request>
<response>
<qrcodeinfo>
<qrcode>https://qr.alipay.com/ocx09863drhqewuprmuzm68</qrcode>
</qrcodeinfo>
</response>
<sign>39c65ea091096e63f934506582035005</sign>
<sign_type>MD5</sign_type>
</alipay>
Request is failed:
<alipay>
<is_success>F</is_success>
<error>ILLEGAL_SIGN</error>
</alipay>