Top-up with Wallet

You can create and top up the virtual cards using WageCan wallet. Please contact support and complete the necessary identity verification. Once you complete the process, you can deposit any amount of USD into your wallet and then use the API to create a new card or top up an existing card.

Get Balance

Obtain wallet balance. Currently only USD are supported.

Request

• Path: /merchant/wallet/balance
• Method: GET

Response

• 200

  Name	Type	Required	Description
  currency	String	v	usd
  balance	String	v	USD balance

• 400

  Name	Type	Required	Description
  message	String	v	Error message

Wallet Top-up

Top up cards from wallet balance. If no cardId is included in the request, a new card will be created.

• Please note that there will be a slight delay in card creation and will not be generated immediately. Please use the query function to find the associated card information.

Request

• Path: /merchant/wallet/topup

• Method: POST

• Request Body

  Name	Type	Required	Description
  amount	String	v	USD amount
  cardId	String		Specify an existing card. If cardId is not specified, a new card will be created.
  productId	String		Specify the product to be created. If no productId is included in the request, the default product will be used.

Response

• 200

  Name	Type	Required	Description
  id	String	v	Top-up ID
  createdAt	String	v	Creation timestamp
  currency	String	v	usd
  amount	String	v	Top-up amount
  cardId	string		The card associated with the request.
  productId	String		The product associated with the request.

• 400

  Name	Type	Required	Description
  message	String	v	Error message

Query Wallet History

Query wallet history. The start date and end date cannot differ by more than 3 months.

Request

• Path: /merchant/wallet/history{?startDate,endDate,skip,limit}

• Method: GET

• Query Strings

  Name	Type	Required	Description
  startDate	String	v	start date format:YYYY-MM-DD
  endDate	String	v	end date (exclude) format:YYYY-MM-DD
  skip	String		Quantity to skip default: 0
  limit	String		Quantity to query default: 25

Response

• 200

  Name	Type	Required	Description
  items	[Wallet History]	v	Array of wallet history
  start	Integer	v	Start position of the query
  count	Integer	v	Quantity of items
  total	Integer	v	Quantity of queries

• 400

  Name	Type	Required	Description
  message	String	v	Error message