Geoswift Balance Query Interface

Description

This interface is used to query the balance of the merchant's account in Geoswift.

Interface endpoint

https://apis.geoswift.com/overseas/account/query

Name	Type& Max	Description	Requirement
requestId	varchar(50)	The requestId is an ID generated by the merchant. This ID is unique for each merchant and can be used for ensuring the uniqueness of the request. If the ID has been used previously, the system will respond “order already exists”	M
merchantId	varchar(9)	The unique identity of the merchant in Geoswift system.	M
accountType	-	Account Type:	O
		FUND_ACCOUNT
		RESERVE_ACCOUNT
		SETTLEMENT_ACCOUNT
		Note:at present, the settlement account only exists when the currency is CNY, and it does not exist when the currency is not CNY. When this parameter is not passed,the default value is FUND_ACCOUNT.
currency	varchar(3)	Currency:	M
		CNY
		USD
		EUR
		JPY
		GBP
		HKD
		AUD
		CAD
		CNH
		SGD
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

{ "requestId":"1594696372203" "merchantId":"G90008001", "accountType":"FUND_ACCOUNT", "currency":"USD", "hmac":"KCiIa0OygIOjln1vzqqaw8+V4/8owsZ78RyulzotUHb3ucfT810hkCtT8G6DDnsG90K+ N4MLjMvzIIelAIEYGx/mFKkl33NBnRclLEHCp/muFEE66t+n63muQygubhErwqilR/slsv5gikF qpafb6Y0hNML1BDrEiSHDoToGeGzd7puJGhgKtul7ILCeJsfpFl+slSm2X3lpd1Mm7wQMi8Xa YGNlb8nuuG+UXYRykort+bd5kLNcx61ArYkUjzFsyYxHihvi8IX1JD7J2sgJ3e1dVxbRunojlX4 RvXLxXhf1FVYT8gOTlGn3DgRI1H+n21uzI2VOzlgnPPGBEQ3aYg==", }

Response Fields

Name	Description
requestId	The request ID
merchantId	The unique identity of the merchant in Geoswift system.
balance	Total balance of account, unit: Yuan
accountType	Account Type:
	FUND_ACCOUNT
	RESERVE_ACCOUNT
	SETTLEMENT_ACCOUNT
resMessage	Error message
currency	Currency:
	CNY
	USD
	EUR
	JPY
	GBP
	HKD
	AUD
	CAD
	CNH
	SGD
availableBalance	Available balance of account, unit: Yuan
frozenAmount	Account frozen amount, unit: Yuan
status	The request status:
	SUCCESS
	FAILED
	ERROR
timestamp	Timestamp, the number of milliseconds at the current time
hmac	The result of parameter signature,generated by Geoswift.For the signature verification process,please reference to "Geoswift encryption and decryption process specification"

Sample

{ "requestId":"1594696372203", "merchantId":"G90008001", "balance":"3190.61", "accountType":"FUND_ACCOUNT", "resMessage":"SUCCESS!", "currency":"USD", "availableBalance":"3001.16", "frozenAmount":"189.45", "status":"SUCCESS", "timestamp":"1618820137963", "hmac":null }