Gateway

Unified ordering interface, through which all payment requests are initiated to the payment platform. According to different payment methods, the request parameters and return data are different, and the business can choose different interfaces according to different usage scenarios.

1. The key parameters are access_token, ciphertext.
2. access_token: The merchant number provided by the platform
3. ciphertext: The merchant loads the parameters specified by the interface into the json string, and then encrypts the ciphertext obtained by using the public key provided by the platform
4. If currency is submitted in the currency field, the currency conversion function is automatically enabled, which will convert the amount you submitted into the channel currency amount before submitting payment. (The converted exchange rate is subject to the daily updated exchange rate of our company, and the final submitted amount is subject to the actual amount. Please know. If you need to inquire about the exchange rate of our company's order, you can use the interface of inquiring the exchange rate of order)
   "Due to the change of business policy, our company has not enabled the conversion function yet, and this field is temporarily unavailable"
5. The timestamp field has not been verified by our company for the time being, and the timestamp transmission is used as a standby security parameter, so there is no need to worry about the server time and other issues leading to submission failure
6. If the payment channel type used is mail payment (which can be confirmed in the merchant center-my interface), the email field is required and the callfront field is invalid, and the interface will always consider the submission value to be-1.

Order refund interface, which can be used by merchants to submit refund requests and refund a successfully paid order

1. The key parameters are access_token, ciphertext.
2. access_token: The merchant number provided by the platform
3. ciphertext: The merchant loads the parameters specified by the interface into the json string, and then encrypts the ciphertext obtained by using the public key provided by the platform
4. After decryption, the orderno and requestid fields cannot be empty at the same time, and the orderno query will be used first; Requestid must only find a unique order for this interface to work
5. The cmd field is used to specify the order status to be operated on, for example:
   When the value is 0 (Auto), if the order is not settled, it will be refunded in the unsettled mode (Void), and if the order is settled, it will be refunded in the settled mode (Refund).
   When the value is 1 (Void), only the target order can be refunded if it is in the unsettled status;
   When the pass value is 2(Refund)the target order can only be refunded if it is in the settled status(the balance will be deducted from the settlement wallet of the order, and the balance in the wallet needs to be sufficient.)

Each time the refund status is updated, the system will send a notification to the callback address of the refund, after successfully revice the callback, please response with "SUCCESS"，Otherwise for each order, the system will only send callback notifications 6 times at most.

1. Return only have one parameter: ciphertext
2. ciphertext：The platform loads the preset parameters into the json string, and then encrypts the ciphertext obtained by using the private key saved by the platform

Payment ordering interface, which can be used by merchants to submit payment requests. Payment will usually be reviewed within 1 working day and received within 1 ~ 3 working days.

1. The key parameters are access_token, ciphertext.
2. access_token: The merchant number provided by the platform
3. ciphertext: The merchant loads the parameters specified by the interface into the json string, and then encrypts the ciphertext obtained by using the public key provided by the platform
4. The merchant order number is mainly used for uniqueness judgment to avoid submitting repeated payment requests. The order number of the paying merchant does not conflict with the order number of the paying merchant, but can be the same.
5. Available collection currency is usually CNY
6. The callback address is the background setting by the merchant preferentially. If the background of the merchant is not set, it will be subject to the payment submission. If the callback address is not specified, it will be deemed that the payment callback is not required
7. The bank code can be used in the bankcode field. Please refer to[List of Paying Banks][Json Format]

After the payment is approved and the transfer is successful, the system will send a notification to the callback address of the payment order respectivelyPlease respond to uppercase SUCCESS if the callback is successfully receivedOtherwise, the system will send up to 6 callback notifications per order.

1. Returns ciphertext with only one parameter
2. ciphertext：The platform loads the preset parameters into the json string, and then encrypts the ciphertext obtained by using the private key saved by the platform

Payment status query interface, through which business applications can query the status of payment orders to update the order payment status of business parties; The business party can also monitor the payment result notification sent by the payment platform and update the payment status of the business system.

1. The key parameters are access_token, ciphertext.
2. access_token: The merchant number provided by the platform
3. ciphertext: The merchant loads the parameters specified by the interface into the json string, and then encrypts the ciphertext obtained by using the public key provided by the platform
4. Orderno and requestid fields cannot be empty at the same time, so Orderno query is preferred;
5. If the merchant opens and allows the merchant order number to be duplicate, the same requestid may find multiple results and return all the results together.

Interface for querying order refund status.

1. The key parameters are access_token, ciphertext.
2. access_token: The merchant number provided by the platform
3. ciphertext: The merchant loads the parameters specified by the interface into the json string, and then encrypts the ciphertext obtained by using the public key provided by the platform
4. The three fields of orderno, requestid and refordernocannot be empty at the same time,and the query priority is: reforderno > orderno > requestid;
5. If the merchant opens and allows the merchant order number to be duplicate, the same requestid may find multiple results and return all the results together

Interface for querying payment order status.

1. The key parameters are access_token, ciphertext.
2. access_token: The merchant number provided by the platform
3. ciphertext: The merchant loads the parameters specified by the interface into the json string, and then encrypts the ciphertext obtained by using the public key provided by the platform
4. orderno and requestid fields cannot be blank at the same time,and the query priority is: orderno > requestid;

If the optional parameter currency is used when placing an order, currency conversion will be carried out automatically (please consult our company if you need to turn on this function to use it). This interface is used to query the exchange rate to be used for currency conversion, so that the amount to be paid will be displayed in advance on your payment page.

1. Returns ciphertext with only one parameter
2. Currency and aimcurrency fields can be left blank, that is, all currencies supporting conversion are returned. If conversion function is not turned on, an empty array is returned
3. ciphertext: The platform loads the preset parameters into the json string, and then encrypts the ciphertext with the private key saved by the platform

Query the exchange rate used in the single currency conversion function of our company

1. The key parameters are access_token, ciphertext.
2. access_token: The merchant number provided by the platform
3. ciphertext: The merchant loads the parameters specified by the interface into the json string, and then encrypts the ciphertext obtained by using the public key provided by the platform

The currency of the amount submitted by the proxy payment interface is the currency of the actual payment, not the currency of the deduction from your wallet balance. If you want to specify the debit amount in your wallet, you can use this interface to automatically convert the expected payment amount for you.

1. return only one parameter: ciphertext
2. ciphertext: The platform loads the preseted parameters into the json string, and then encrypts the ciphertext with the private key saved by the platform

On-line encryption and decryption interface is used to replace the original encryption and decryption class for on-line encryption and decryption when it is inconvenient or impossible to use the original source code for RSA encryption and decryption in some language environments. (For example, ASP, please refer to ASP Demo of our company)

1. The key parameters are pubkey, cmd, ciphertext (required when cmd value is 2).
2. When the cmd value is 1, it is encrypted mode, and all fields except pubkey and cmd are regarded as data to be encrypted
3. When the cmd value is 2, it is decryption mode, which will decrypt the ciphertext in the ciphertext field based on pubkey
4. This interface is an optional auxiliary interface, so it is recommended to try RSA encryption and decryption in native environment first.
5. Because of URL length and Urlencode standard, the usage scenario of 5. GET mode has certain limitations. If it is not necessary, it is recommended to use POST encryption and decryption interface first

On-line encryption and decryption interface is used to replace the original encryption and decryption class for on-line encryption and decryption when it is inconvenient or impossible to use the original source code for RSA encryption and decryption in some language environments. (For example, ASP, please refer to ASP Demo of our company)

1. The key parameters are pubkey, cmd
2. Encryption mode when the cmd value is 1, the plaintext field is required, and the json or other string to be encrypted is passed in
3. When the cmd value is 2, it is decryption mode, ciphertext field is required, and ciphertext to be decrypted is passed in
4. This interface is an optional auxiliary interface, so it is recommended to try RSA encryption and decryption in native environment first