GET
/
billing
/
customers
/
{customer}
Retrieve Customer
curl --request GET \
  --url https://api.momentco.io/billing/customers/{customer} \
  --header 'Authorization: Bearer <token>'
{
  "id": "bcus_H4jp6KnU5cPw263v1jyz4",
  "external_reference": "UCR1234567890",
  "name": "John Doe",
  "email": "john.doe@example.com",
  "phone": "+27123456789",
  "currency": "ZAR",
  "balance": 2000,
  "payment_rules": {
    "min_amount": 100,
    "max_amount": 1000000,
    "underpayment_allowed": true,
    "overpayment_allowed": false
  },
  "metadata": {
    "customer_type": "premium",
    "registration_source": "website"
  }
}

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

Path Parameters

​
customer
required

Customer identifier - either the unique ID provided by Moment or the external reference provided by the merchant.

External reference for reconciliation or tracking purposes. This field allows you to associate the payment link with your internal systems. Must be unique within your merchant account.

Maximum length: 255
Example:

"INV-2024-001"

Response

200
application/json

Customer retrieved successfully

A customer represents an individual or business entity that can have accounts and bills within the billing system.