{"templateId":"markdown","versions":[{"version":"v1","label":"v1","link":"/api-reference/v1/components/docs/customers","default":true,"active":false,"folderId":"1b9c9f54"},{"version":"v2","label":"v2 (Beta)","link":"/api-reference/v2/components/docs/customers","default":false,"active":true,"folderId":"1b9c9f54"}],"sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Flute Developer","siteUrl":"https://developer.flute.com","description":"Documentation and API reference for integrating Flute payment processing.","lang":"en-US","llmstxt":{"hide":true,"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Customers are entities used to organize and manage saved payment methods."," ","These include billing details, transaction history, and recurring payments."," ","A customer record may contain their name, email address, phone number, billing, and shipping addresses."," ","Having a customer association is not required to pay for transactions."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Creating a customer"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","Customers may be created in the following ways:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Explicitly with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /pay-api/v1/customers"]},"."," ","This includes full customer details and optional payment methods."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Merchant Portal. Merchants and their partner can create customers through this portal."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Implicitly with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/pay-int-api/payment-sessions"]},"."," ","When this endpoint's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mode"]}," is either ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SaveMethod"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PaymentAndSave"]},", if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customerId"]}," is not provided, one will be created."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Implicitly with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /pay-int-api/invoices/publish"]},"."," ","If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customerId"]}," is not provided, one will be created."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["New ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customerId"]}," values can be reviewed with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v2/customers"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pay transactions"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","Customers may pay transactions in one of three ways:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Vaulted payments"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Standalone tokenization, also known as orphan vaulted payment"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Account supported"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Vaulted payments"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","Customers can be associated with one or more vaulted payment methods."," ","A vaulted payment method is a securely stored payment credential."," ","This applies to credit card or bank account payments."," ","A vaulted payment method is a securely stored payment credential."," ","This is considered a more secure method rather than storing the card number directly."," ","That information has previously been tokenized and saved for future use."," ","Vaulted information can be safely accessed through a payment identifier."," ","This is typically used for recurring billing, subscriptions, saved checkout experiences, and card-on-file transactions."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the transaction payment, the field ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customerId"]}," is provided."," ","The customer's vaulted payment methods are available for selection."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Standalone tokenization"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","Clients may use standalone tokenization, also known as an orphan vaulted payment."," ","This allows a payment method to be vaulted even when the payer has not been recognized as a customer entity."," ","The transaction proceeds using a previously established payment method identifier."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Standalone tokenization is useful when a payment method must be vaulted before a customer profile exists."," ","This includes guest checkouts, delayed onboarding, account setup, or card-on-file collection before registration is complete."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the transaction payment, the field ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customerId"]}," is omitted but ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentMethodId"]}," is provided."," ","This indicates the merchant's orphan vaulted payment method is used."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Accounts Supported"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","Clients may use accounts supporting orphan payments."," ","This is a form of a payment method that temporarily exists without a customer association."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the transaction payment, both fields ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customerId"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentMethodId"]}," are omitted."," ","The transaction uses the credit or debit card, or bank account data supplied in the request."]}]},"headings":[],"frontmatter":{"seo":{"title":""}},"lastModified":"2026-07-08T15:40:38.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/api-reference/v2/components/docs/customers","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}