Packet Header Setting

When requesting APIs, please ensure that the request endpoint and the encryption process are correct. Also, the request method needs to be set as POST, and the code is set into "UTF-8."

Key	Key value	description
merchantId	The value of the merchant ID	The unique ID that Geoswift assigns to the merchant and is obtained form the merchant's back end
requestId	The value of the request ID	Transaction number generated by merchant; This filed will not be passed If the business does not include the transaction number
partnerId	The value of the partner ID	The unique ID that Geoswift assigns to the service provider, corresponding to the merchant number (this filed will not be passed if the service does not have a service provider ID
Content-Type	application/vnd.geoswift-v3.0+json	The fixed value of the request header
encryptKey	The data encrypted by the public key	The ecnypted version of the AES key's value(The key is encrypted by the public key

Sample

{ "merchantId": "G90009007", "requestId": "100000000000000", "ContentType" = "application/vnd.Geoswift-v3.0+json", "partnerId"="G90009005", "encryptKey"="OsYlS3vP1I+m5csUDTSbi801evXvMDsMejLHtqIqbtA5Q TdPTjvCE2q4NLFek53Sqo0HxjcHxxgbX5QMEM7y0VMmeUmaLJ7BK/RR 3Zc5xtHkWE/AbO8ErG7oXgORZ6JVakeRlDG8sSVTT2Duvy38RsXUQC4 Vj4VHgxsLq398vfYQZgf9O8FPfSc+m7g8MGhbbuqMSbOWBH1lDKnCkp l93XSiWFYHICt7aO/P9avhqlSVJDQg2KpwMld6Mfag5hgz/LTE7Dfwy ueH6VxIU7rrUkelWZSbO3ULUg7G5okRAFvXJPqfTnkRnQ+qTsK3QOpb 98XlaR+tjuYqzTWs+/mUVg==" }

Exception Description

When an exception occurs during the period of requesting API, it would return the following parameters generally; If your system receives this type of repoinse message, there is not need to veiry the signature; Below is the detail for each parameter's description.

Key	Key value
merchantId	the value of the merchantId
code	the value of the error code
status	ERROR
error	Error description
cause	The error's cause

Sample

{ "cause": "{\"bankCardNumber\":{\"message\":\"bankcardnum.invalid\"}}", "code": "E1004016", "error": "方法参数无效", "merchantId": "890001312", "status": "ERROR" }