Geoswift server will notify the merchant in the following scenarios:
1、When an order request requires review and the customer needs to submit supporting documents.
2、When an order review status is “RETURN” and the customer needs to provide additional information.
3、When an order request review is approved or rejected.
| Scenario | Payment Notification Status Returned by Geoswift | ||
| status (Payment Status) | proofStatus (Proof Submission Status) | reviewStatus (Review Status) | |
| Initial Remittance by User | PROCESSING (Processing) | INIT (Pending Upload) | INIT (Initialized) |
| Merchant Uploads Proof of Payment | PROCESSING (Processing) | SUCCESS (Uploaded) | WAIT (Pending Review) |
| Review Rejected, Additional Information Required | PROCESSING (Processing) | WAIT_ADD (Pending Additional Materials) | RETURN (Returned for Revision) |
| Review Rejected, Credited Failed | REFUND_INIT (Pending Refund) | SUCCESS (Uploaded) | REFUSE (Review Rejected) |
| Review Rejected, Refund Completed | REFUND_SUCCESS (Refund Successful) | SUCCESS (Uploaded) | REFUSE (Review Rejected) |
| Review Approved, Credited Successful | BOTH_SUCCESS (Credited Successfully) | SUCCESS (Uploaded) | SUCCESS (Review Approved) |
| Subsequent Remittance by User, No Review Required | BOTH_SUCCESS (Credited Successfully) | INIT (Pending Upload) | NOT_NEED (No Review Required) |
| Name | Description |
|---|---|
| merchantId | The unique identifier of the merchant in the Geoswift system |
| partnerId | The unique identifier of the service provider in the Geoswift system |
| id | Request ID |
| accountNo | Global collection account number |
| currency | Currency |
| amount | Amount in cents; 1 dollar = 100 cents |
| feeAmount | Fee amount in cents; 1 dollar = 100 cents |
| establishmentFeeAmount | VA opening fee |
| proofStatus | INIT：Awaiting upload; WAIT_ADD：Awaiting additional documents; SUCCESS：Uploaded; NOT_NEED：No upload required. |
| status | Fund collection status: INIT：Initialized; PROCESSING/GS1_SUCCESS/GS2_SUCCESS：Processing； BOTH_SUCCESS：Credited; REFUND_INIT：Awaiting refund; REFUND_SUCCESS：Refunded; |
| createDateTime | Fund collection time |
| senderAccountName | Sender Account Name |
| senderAccountNo | Sender Account No |
| Review status: |
NOT_NEED：No review required; INIT：Initialized; WAIT：Awaiting review; SUCCESS：Approved; RETURN：Returned; REFUSE：Rejected. |
| reviewRemark | Review comments |
| senderCountry | Country code ，example US |
| hmac | Parameter signature generated by Geoswift. For details on signature verification, refer to the "Geoswift Encryption and Decryption Process Specification" |