Skip to main content
POST
/
stored_value
/
lookup
curl --request POST \
  --url https://api.momentpay.net/stored_value/lookup \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "vouchers.ott",
  "source": {
    "pin": "9988776655443322",
    "phone_number": "+27821234567"
  }
}
'
{
  "type": "vouchers.ott",
  "balance": 5000,
  "currency": "ZAR",
  "source": {
    "pin": "9988776655443322",
    "phone_number": "+27821234567"
  },
  "provider_metadata": {
    "pin_status": "active",
    "denomination": 5000
  }
}

Authorizations

​
Authorization
string
header
required

Authentication using Bearer tokens. Include your API key in the Authorization header.

Key Types:

  • Test Keys: sk_test_* for development and testing
  • Live Keys: sk_* for production environments
  • Public Keys: pk_test_* or pk_* for client-side operations

📩 Need access? Contact Support to request your API keys.

Usage:

Authorization: Bearer sk_test_4eC39HqLyjWDarjtT1zdp7dc

Body

application/json

Request body for a stateless stored value lookup.

​
type
enum<string>
required

Namespaced redemption type in category.type form. The category selects the value class and the suffix selects the specific provider that will fulfil the redemption.

Only the vouchers category is available today. Loyalty point categories (for example loyalty_points.skywards, loyalty_points.ebucks) are planned.

Available options:
vouchers.one_voucher,
vouchers.ott,
vouchers.blu
​
source
OTT · object
required

Provider specific source credential object for a stored value lookup. The shape is owned by the adapter and selected by the parent type field.

1Voucher does not expose a stored value lookup and is not represented here. A lookup request for 1Voucher is still validated but returns HTTP 422.

Response

Lookup result.

Generic envelope returned by a successful stored value lookup.

​
type
enum<string>
required

Namespaced redemption type in category.type form. The category selects the value class and the suffix selects the specific provider that will fulfil the redemption.

Only the vouchers category is available today. Loyalty point categories (for example loyalty_points.skywards, loyalty_points.ebucks) are planned.

Available options:
vouchers.one_voucher,
vouchers.ott,
vouchers.blu
​
balance
integer

Stored value balance in minor units (cents).

​
currency
string
Required string length: 3
​
source
OTT · object

Echo of the provider specific source the lookup was performed against.

​
provider_metadata
OTT · object

Provider specific result fields returned by a stored value lookup. The shape is selected by the parent provider field. Only keys returned by the upstream provider are present.

​
error
object

Provider mapped error attached to a failed operation or to a failed redemption aggregate.