Customer Service

Overview

The Customer Service enables you to create and manage customer profiles at payment processors. Storing customer details with connectors streamlines future transactions, reduces checkout friction, and improves authorization rates by maintaining a consistent identity across multiple payments.

Business Use Cases:

E-commerce accounts - Save customer profiles for faster checkout on return visits
SaaS platforms - Associate customers with subscription payments and billing histories
Recurring billing - Link customers to stored payment methods for automated billing
Fraud prevention - Consistent customer identity improves risk scoring accuracy

The service creates customer records at the underlying payment processor (Stripe, Adyen, etc.), allowing you to reference the same customer across multiple transactions without resending personal information.

Operations

Operation	Description	Use When
`Create`	Create customer record in the payment processor system. Stores customer details for future payment operations without re-sending personal information.	First-time customer checkout, account registration, subscription signup

Common Patterns

New Customer Checkout Flow

Create a customer profile during first-time checkout, then use the customer ID for future payments and payment method storage.

sequenceDiagram
    participant App as Your App
    participant CS as Connector Service
    participant PP as Payment Provider

    Note over App: New customer checkout
    App->>CS: 1. Create (customer details)
    CS->>PP: Create customer profile
    PP-->>CS: Return connector_customer_id
    CS-->>App: Return connector_customer_id (cus_xxx)
    Note over App: Store connector_customer_id with user account
    App->>CS: 2. Authorize (with connector_customer_id)
    CS->>PP: Create payment linked to customer
    PP-->>CS: Return authorization
    CS-->>App: Return connector_transaction_id (AUTHORIZED)
    Note over App: Future transactions
    App->>CS: 3. Authorize (with same connector_customer_id)
    CS->>PP: Create payment linked to existing customer
    PP-->>CS: Return authorization
    CS-->>App: Return connector_transaction_id (AUTHORIZED)

Flow Explanation:

Create customer - Send customer details (name, email, phone) to the Customer Service. The connector creates a profile at the payment processor and returns a connector_customer_id (e.g., Stripe's cus_xxx). Store this ID in your user database for future reference.
Authorize payment - When the customer makes a payment, call the Payment Service's Authorize RPC with the connector_customer_id. This reserves funds on the customer's payment method and links the transaction to their profile. The response includes a connector_transaction_id and status AUTHORIZED.
Future transactions - For subsequent payments, reuse the same connector_customer_id. The payment processor recognizes the returning customer, which improves authorization rates and enables features like saved payment methods.

Benefits:

Streamlined checkout for returning customers
Better authorization rates through customer history
Simplified payment method management
Unified customer view across payment processors

SaaS Subscription Onboarding

Create customer during signup, then use the stored customer ID for initial subscription charge and recurring payments.

sequenceDiagram
    participant App as Your App
    participant CS as Connector Service
    participant PP as Payment Provider

    Note over App: New subscription signup
    App->>CS: 1. Create (signup details)
    CS->>PP: Create customer profile
    PP-->>CS: Return connector_customer_id
    CS-->>App: Return connector_customer_id
    Note over App: Set up payment method
    App->>CS: 2. Tokenize (with connector_customer_id)
    CS->>PP: Store payment method for customer
    PP-->>CS: Return payment_method_id
    CS-->>App: Return tokenized payment method
    Note over App: Initial subscription charge
    App->>CS: 3. Authorize (with connector_customer_id)
    CS->>PP: Create payment for customer
    PP-->>CS: Return authorization
    CS-->>App: Return connector_transaction_id
    App->>CS: 4. Capture
    CS->>PP: Capture funds
    PP-->>CS: Return capture confirmation
    CS-->>App: Return status: CAPTURED
    Note over App: Subsequent billing via RecurringPaymentService

Flow Explanation:

Create customer - During signup, send customer details to Customer Service. The payment processor creates a customer profile and returns a connector_customer_id. This links all future transactions to this customer.
Tokenize payment method - Collect the customer's payment details and call Payment Method Service's Tokenize RPC with the connector_customer_id. The connector securely stores the payment method and returns a token that can be used for future charges without handling raw card data.
Authorize payment - For the initial subscription charge, call Payment Service's Authorize RPC with both the connector_customer_id and the tokenized payment method. This reserves the funds on the customer's card.
Capture payment - Once the authorization is confirmed, call the Payment Service's Capture RPC to finalize the charge and transfer funds. The status changes from AUTHORIZED to CAPTURED.
Subsequent billing - For future billing cycles, use the Recurring Payment Service's Charge RPC with the stored connector_customer_id and payment method token to process payments without customer interaction.

Next Steps

Payment Service - Process payments linked to customers
Payment Method Service - Store and manage customer payment methods
Recurring Payment Service - Set up recurring billing for customers

Overview​

Operations​

Common Patterns​

New Customer Checkout Flow​

SaaS Subscription Onboarding​

Next Steps​