Payment Order Close Interface

Description

Merchant use Geoswift aggregated payment order close interface to close the order that unpaid on Geoswift platform.At present, only WeChat code scanning payment and WeChat APP payment orders are supported. When the payer has not paid for a long time, in order to prevent repeated payment, the merchant can take the initiative to close the order to prevent the payer from continuing to pay the order.

Request Endpoint

https://apis.geoswift.com/cp/closeOrder

Name Type& Max Description Requirement
merchantId varchar(9) The unique identity of the merchant ID in Geoswift system. M
partnerId varchar(9) The unique ID of the service provider in the Geoswift system C
requestId varchar(50) The order number is generated by the merchant, the order number must be the unique on the transaction platform. Request/order which had been paid or canceled in Geoswift's platform can’t be submitted with the same request ID. M
payOrderRequestId varchar(50) The requestId of the original order. M
remark varchar(300) It is for merchants to remark request in Geoswift ,which would be returned to merchant synchronously. O
hmac varchar(500) The result of parameter signature,generated by the merchant.For the method of obtaining hmac,please reference to "Geoswift encryption and decryption process specification" M

The preceding parameter values cannot contain the following special characters: '" &<>()

Sample

{ "merchantId": "G90008002", "requestId": "1616658567415", "payOrderRequestId": "1616658528043", "remark": "备注", "hmac": "Q9ot1Fz+26rgNJYtcUvVK1GTkhXsOFGKW2iJ4Cntdchnn/trrpW6rDCIREVlZZdbbbt23Vn quM6uxUEpip5X6BB2ft1X5F4KsGeqQsCdYN2Qt/Am5/P2mAaXE/E/z98NZO0wKbGxi5ZfZMYOYGfqzyh Nou6AyUQvnqf5C9N0CaXTqGUYjg3dc4dlSPOjx/ez6/f4LNQ3z3dZfaM/DYuEnPIzjoTr9h7orYgsiBO RPAUachK0q24yO7HTgbXu0XRwmiQ80SZjD9XtzOovsA3YXmwQKjIMOtcO49p4qxaKuHW1nAtAfcDsI43 lI/hCWJzCjpPhZBGWjTWaM6S18DQIvw==" }

Response Fields

Name Description
merchantId The merchant IDThe unique identity of the merchant ID in Geoswift system.
partnerId The unique ID of the service provider in the Geoswift system
requestId The order number is generated by the merchant, the order number must be the unique on the transaction platform. Request/order which had been paid or canceled in Geoswift's platform can’t be submitted with the same request ID.
payOrderRequestId The requestId of the original order.
remark remark
serialNumber Serial number of the order that is going to be closed.
completeDateTime The completion time of the order close request
status Response status
SUCCESS
FAILED
ERROR
closeOrderStatus INIT
PROCESSING
SUCCESS
FAILED
errorMessage Error message
hmac The result of parameter signature,generated by Geoswift.For the signature verification process,please reference to "Geoswift encryption and decryption process specification"

Sample

{ "redirectUrl": "https://qa-gs-cashier.geoswift.com/receipt/redirect/index /2c9980957a2c66a2017a2d17967b005b/2c9980957a2c66a2017a2d1796d1005e", "serialNumber": "2c9980727a2c6c68017a2d1795490029", "merchantId": "G90008005", "requestId": "16242538053223", "orderStatus": "PROCESSING", "status": "REDIRECT", "hmac": "uFzGnMExQgcCbxDjDbgjitCVK6+iD3qvxhQfk3DuDyfaJcXyiobyh8XBC4/jLpgF SidLjxYXdnX9bP4iom3wStOOh05ohGWvYbdLHh31bKMmjITouKH05SfUOIno15vrENfUu8wbr f0lIOx3tslTg2LAeAd+s9ekEVBq5ZvW06gKfOtmRzAtVTtT+weUxDo/R/vs7jK16rN3Gi4Jd6 YVmbPJFJCtkeGZJY1CkdfFFlYFoyIPY3/XvGUnw8KgAkQ8KlZIgzjWqBfiLyO7gcSWC1nybBK tGTqdux2a/vinahPNcRdmN+BBauk65qaAEZnNaTLFsUtmc/b724P0PKKKKQ==" }