Customers
Link a PayNowPro customer record to a stable customer identifier from your own system.
A customer represents one of your end users in PayNowPro. Create a customer before you start a subscription payment flow, then keep the returned PayNowPro customer ID alongside the customer ID in your own application.
Customer identity
Each customer has two identifiers:
| Identifier | Who supplies it | How to use it |
|---|---|---|
associatedId | You | A stable, unique ID for the customer in your system, such as a database UUID. |
id | PayNowPro | The ID returned after the customer is created. Use it for PayNowPro customer and subscription operations. |
PayNowPro validates associatedId when creating a customer and prevents duplicate customer records for the same tenant and associated ID. Do not use an email address as the identifier if the email can change.
Customer data
A customer record includes first name, last name, email, tenant alias, associated ID, creation time, and optional string metadata. Use metadata only for data that helps your integration; do not place card details, API keys, passwords, or sensitive authentication data in it.
The public customer API supports these lifecycle operations:
- Create a customer.
- List customers with cursor pagination.
- Retrieve one customer by PayNowPro ID and associated ID.
- Update first name, last name, or metadata.
- Delete a customer.
Treat deletion as a consequential operation. Check how it affects your application's access, billing, and retention requirements before you request it.
Use customers for subscriptions
A subscription-intent request requires both customerId and associatedCustomerId. The first is the PayNowPro customer ID; the second is the same stable identifier you supplied as associatedId.
curl -X POST "https://api.paynowpro.com/api/v1/customers" \
-H "api-key: YOUR_API_KEY" \
-H "content-type: application/json" \
-d '{
"tenantAlias": "YOUR_TENANT_ALIAS",
"associatedId": "user_123",
"firstName": "Avery",
"lastName": "Brown",
"email": "avery@example.com"
}'Save the returned PayNowPro id beside user_123 in your application.
Next, read Create and manage subscriptions or use the Customers API reference.