GET
/
v1
/
pay
/
members
/
{memberId}
/
balance

Returns the balance of a member, and any withdrawal limits that apply to the member.

Current Balance

The available field represents the actual balance a member currently has for withdrawal.

Withdrawal Limits

The lowerLimit and upperLimit fields define the range of amounts that a member is allowed to withdraw:

  • Lower Limit (lowerLimit): The minimum amount a member can withdraw.
  • Upper Limit (upperLimit): The maximum amount a member can withdraw.

These limits do not directly factor into the balance but instead serve to restrict the amount a member can withdraw in a single transaction.

Computation of Withdrawable Amount

Given the available balance and the limits, the withdrawable amount can be computed as follows:

  • Minimum Withdrawable Amount: Is always the lowerLimit, as if the balance is less than the lower limit they cannot withdraw.
  • Maximum Withdrawable Amount: This is the smaller value between the available balance and the upper limit.
    Maximum Withdrawable Amount = min(available, upperLimit)
    

Authorizations

X-API-KEY
string
headerrequired

Headers

x-idempotency-key
string

Unique key to ensure idempotency of the request

Path Parameters

memberId
string
required

The unique identifier for a Member, prefixed with mem_

Response

200 - application/json
available
object
required

The balance for the member

lowerLimit
object
required

The lower limit, the member cannot withdraw below this amount

upperLimit
object
required

The upper limit, the member cannot have more than this amount

payCycle
object
required