alipay.fund.auth.operation.detail.query
Call the alipay.fund.auth.operation.detail.query interface to query detailed information of a funds pre-auth operation.
Request
Service address
Environment | HTTPS request URL |
Production environment | |
Test environment |
Request parameters
Parameter | Description |
Basic parameter | |
app_id String (32) | The unique ID that is assigned by Alipay to identify an application. Example: |
method String (128) | Interface name Example: |
format String (40) | Only JSON is supported. Example: |
charset String (10) | The charset with which the request data is encoded. GBK and UTF-8 are supported. Example: |
sign_type String (10) | Signature type. RSA and RSA2 are supported. Use uppercase. Example: |
sign String (344) | Signature value |
timestamp String (19) | The time when the merchant server sends the request. The format is yyyy-mm-dd hh:mm:ss. Example: |
version String (3) | The API version. The value is fixed as 1.0. Example: |
notify_url String (256) | The URL for receiving asynchronous notifications after the pre-auth is completed. Example: |
app_auth_token String (40) | To query authorization information. Example: Note: After a merchant authorizes an ISV to use certain APIs, Alipay will assign an app_auth_token to the ISV. The ISV can use this interface to query the authorization information such as the authorizer and authorized APIs corresponding to the app_auth_token. For more details, see Overview of the app authorization (in Mandarin). |
biz_content String | Collection of request parameters. The maximum length is not limited. Except for common parameters, all other request parameters must be passed in to this parameter. |
Business parameter | |
auth_no String (64) | The pre-auth order number assigned by Alipay. This parameter is required when out_order_no is not provided. If auth_no and out_order_no appear at the same time, auth_no takes precedence. Example: |
operation_id String (64) | The serial number of operation assigned by Alipay. This parameter is required when out_request_no is not specified. If operation_id and out_request_no appear at the same time, operation_id takes precedence. Example: |
out_order_no String (64) | The transaction number of funds pre-auth assigned by partner system. This parameter is required when auth_no is not specified. If auth_no and out_order_no appear at the same time, auth_no takes precedence. Example: |
out_request_no String (64) | The serial number of a partner's funds pre-auth request. This parameter is required when operation_id is not specified. If operation_id and out_request_no appear at the same time, operation_id takes precedence. Example: |
Response
Synchronous response
Parameter | Description |
Basic parameter | |
code String (16) | The gateway return code, which indicates whether the request is accepted by Alipay gateway. Example: |
msg String (32) | Description of the gateway return code Example: |
sub_code String (16) | Processing result of the request Example: |
sub_msg String (64) | Description of the processing result of the request |
sign String (344) | The sign value. See Signature for details. |
Business parameter | |
auth_no String (64) | The transaction number of funds pre-auth assigned by Alipay, which is composed of 28 digits. Example: |
operation_id String (64) | The serial number of funds operation assigned by Alipay. Example: |
out_order_no String (64) | The transaction number of funds pre-auth assigned by merchant system. Example: |
out_request_no String (64) | The serial number of funds operation request assigned by merchant system. Example: |
order_title String (100) | Transaction title Example: |
status String(20) | Status of the funds pre-auth. Possible values include:
Example: |
operation_type String (20) | Funds operation type. Possible values include:
Example: |
amount Price (11) | The total amount of funds frozen in the transaction currency, rounded to 2 decimal places. Example: |
remark String (100) | Operations description |
gmt_create Date (20) | The time when the funds pre-auth was created. The format is yyyy-mm-dd hh:mm:ss. Example: |
gmt_trans Date (20) | The time when the funds pre-auth was successful. The format is yyyy-mm-dd hh:mm:ss. Example: |
payer_user_id String (32) | Payer's Alipay user ID. Example: |
payee_logon_id String (100) | The payer's Alipay login ID, email, or phone number are supported. Example: |
pre_auth_type String (32) | Pre-auth type. Only Example: |
total_freeze_amount Price(decimal)11b(9.2) | Total frozen amount. The unit is the transaction currency used when the funds were frozen. Example: |
total_unfreeze_amount Price(decimal)11b(9.2) | The total unfrozen amount. The unit is the transaction currency used when the funds were frozen. Example: |
total_pay_amount Price(decimal)11b(9.2) | The total paid amount. The unit is the transaction currency used when the funds were frozen. Example: |
rest_amount Price(decimal)11b(9.2) | The total paid amount. The unit is the transaction currency used when the funds were frozen. Example: |
trans_currency String (8) | The pricing currency. Use uppercase. Example: |
extra_param String (300) | The extension parameter passed by the merchant when requesting the creation of the pre-auth order. Only the merchant-defined extension information (merchantExt) is returned. Example: |
Error codes
Error Code | Description |
ILLEGAL_ARGUMENT | The parameter is incorrect. Check each request parameter according to the API specification. For cashier, get the customer to refresh the payment code and try the pre-auth again. |
AUTH_ORDER_NOT_EXIST | The pre-auth order does not exist. |
AUTH_OPERATION_NOT_EXIST | The Alipay fund operation number does not exist. |
ACCESS_FORBIDDEN | You have no permission to query this order information. |
SYSTEM_ERROR | System error |