Geoswift Remittance Cancel Interface

Description

Use this call to cancel a particular transaction.

Interface endpoint

https://api.geoswift.com/ofr/remitOrder/cancel

Name Type& Max Description Requirement
merchantId varchar(9) The unique identity of the merchant in Geoswift system. M
requestId varchar(50) Use requestId to cancel a trancaction. M
partnerId varchar(9) The unique identifier of the secondary merchant under the main merchant in the Geoswift system. Note: this parameter can be omitted if the initiating merchant is the main merchant. C
hmac - 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

Sample

{ "hmac": "pivre6EaKalPxgBU9V/MSXwxjBr75tXvj8y7mqW9vcfrRbshpL1UrjJ+8C Ej9ABYzmCmHUt4W8+gLIEWGxNC1kGTyYAkHouJfTpR2Ac4fDJ7zC6WXtHiTZvPZiEBW oU4klqfm0bmvUQtwOswUrcuPjur4mtSpnC5s0kutjGIZBMh0IYPRjuMTj9wPMNX/2mV Rt5Za3tGs7ZOlyCOKsXf51NjnVzQXFYyZSz9rPw7+L/b9yZqFFOxHtvylVKapMhVDvH gb+0cjvYXbU9tbaxbf7oIuWq3MJQ0cWdvSZ6jgelDehIHKi2kRx3kawXY5EHXGcimfs 2yilhvHq7wb/BX0g==", "merchantId": "896666110", "remitRequestId": "1719899240294", "requestId": "1692000008116" }

Returned Parameter Fields

Name Description
merchantId The unique identity of the merchant in Geoswift system.
requestId The request ID
serialNumber Serial number of the remittance in Geoswift system
status The request status:
SUCCESS
ERROR
cancelStatus The cancel status:
CANCELING
CANCELED
FAILED
errorMessage Returned only when "cancelStatus" is FAILED
errorCode Returned only when "cancelStatus" is FAILED
partnerId Same as the request parameter
hmac The result of parameter signature,generated by Geoswift.For the signature verification process,please reference to "Geoswift encryption and decryption process specification"

Sample

{ "cancelStatus": "CANCELED", "hmac": "F1BtGC/+MpwOlP/xgF8Y4x4pJgxF2Yp/z574OY5P8Gn7G9Eoa/BPUnGatSFvFjl98J PRsx1WW7XGwHD5RqlvMPaFACZ05BIuhdArVQ3CyOketOgpVyVaFadnptE/RXfSwdmSudl0GGrss xF+f9ALidg7qc0r5IVGmHKXmwmrVXG+COnuD1efJxQTvzdaKOElGKS7rFAQ4LyQvVAXwK6sfaSY Qp2iiIk0lbnF3PI7T8MC0fI4Xhf4yYIALdfu3MYkCJhXhn3ZkghnHxNUqI/yj9vY13hT9DhvHpD 5OkuHlRrvmVx/jVU4j1Hh+5uGGfzfdgQ3Y6v1CX/9y3YypS8S6w==", "merchantId": "G30000022", "requestId": "1720576960842", "serialNumber": "2c9b928f9096b0b401909b65efb80002", "status": "SUCCESS" }