Collection Proof Uploading Interface(Merchant→Geoswift,Mandatory Interface)

Function Description

Merchants must call this interface to upload proof when the status of the proof uploading "proofStatus" is INIT or WAIT_ADD.

Interface URL

Request endpoint:https://api.geoswift.com/va/order/uploadProof

Name Type&Length Description Required
merchantId varchar(9) The unique identifier for the merchant in the Geoswift system M
partnerId varchar(9) The unique identifier of the secondary merchant under the main merchant in the Geoswift system (this parameter can be omitted if the initiating merchant is the main merchant) C
id varchar(50) Request ID M
proofList varchar(200) Proof File Name:
A comma-separated list of file paths, each representing a proof document. Supports up to 5 files, with a maximum length of 200 characters per path.

E.g. path/to/file1.jpg,path/to/file2.pdf,path/to/file3.jpeg
Note: SFTP supports uploading PNG, JPG, JPEG, PDF, ZIP files. Up to 5 files can be uploaded, with each file not exceeding 10MB
M
hmac varchar(512) The parameter signature generated by the merchant. For obtaining HMAC, please refer to the "Geoswift Encryption and Decryption Process Specification" M

Sample

{ "merchantId": "G30016690", "hmac": "hIopVKWqIacimQEcth3JWruQ==", "proofList": [ "test.TXT", "test.pdf", "test.pdf", "test.pdf", "test.pdf" ], "id": "2c9b929491c12d810191c5299c0b00c1", "partnerId": "G84600130" }

Response Parameter List

Name Description
merchantId Same as request parameter
partnerId Same as request parameter
id Fund collection order ID
status Request status:
SUCCESS
FAILED
ERROR
businessStatus Upload status:
INIT:Pending upload;
WAIT_ADD:Pending additional documents;
SUCCESS:Uploaded;
NOT_NEED:No upload required.
completeDateTime Uploading time
errorCode Error Code
errorMessage Error description
hmac Parameter signature generated by Geoswift. For signature verification process, refer to the "Geoswift Encryption and Decryption Process Specification"

Sample

{ "completeDateTime": "2024-09-06 10:29:35", "hmac": "fkCY9/iZPaMXDeTT87XmExqzc8emMd4Am9UdKkePA==", "id": "2c9b929491c12d810191c5299c0b00c1", "merchantId": "G30016690", "partnerId": "G84600130", "status": "SUCCESS" }