Customer
A Customer represents a buyer you do business with. Use Customers to save payment methods for reuse, track lifetime spend, attach metadata for your CRM, and group related Charges, Refunds, and Checkout Sessions under a single record. Give a Customer your own ID as `externalId` and pass it as `externalCustomerId` on later checkout sessions, so you never need to store the XPay customer ID.
A Customer represents a buyer you do business with. Use Customers to save payment methods for reuse, track lifetime spend, attach metadata for your CRM, and group related Charges, Refunds, and Checkout Sessions under a single record. Give a Customer your own ID as externalId and pass it as externalCustomerId on later checkout sessions, so you never need to store the XPay customer ID.
{ "id": "cus_abc123xyz", "object": "customer", "type": "registered", "createdAt": "string", "updatedAt": "string", "name": "string", "email": "string", "phone": "string", "address": { "line1": "string", "line2": "string", "city": "string", "state": "string", "postalCode": "string", "country": "string", "property1": null, "property2": null }, "externalId": "user_8412", "locale": "ar", "taxIds": [ { "type": "eg_tin", "value": "string" } ], "currency": "EGP", "balance": -5000, "guestFingerprint": { "emails": [ "string" ], "phones": [ "string" ], "cardFingerprints": [ {} ] }, "metadata": { "property1": null, "property2": null }, "merchantId": "string"}Customer Balance Transaction
A Customer Balance Transaction is one change to a customer's balance. The balance always equals the sum of its transactions. A negative balance is credit, used up by the customer's next invoice.
Discount
A Discount records a single application of a Coupon to a specific Checkout Session, PaymentIntent, or Customer. Where a Coupon is the reusable template, a Discount captures the concrete redemption: which Coupon was applied, when it became active, when it expires, and (when applicable) which Promotion Code the customer entered to claim it.