Create a payment method setup request for a customer

post

https://api.inflowpay.com/api/customer/{customerEmail}/payment-methods

Creates a pending setup request that allows a customer to securely save a payment method. Returns a setup request id to pass as setupId to the InflowPay iframe SDK. The SDK handles card collection, tokenization, and 3DS authentication in subsequent steps. The request status advances from pending to completed (or failed) asynchronously once the card is confirmed.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

customerEmail

string

required

Email address of the customer

Body Params

currency

string

enum

required

Currency for the payment method (EUR, GBP or USD). The saved payment method will be usable for charges in this currency.

Allowed:

card

object

PCI / server-to-server only — For merchants who collect and transmit card data through their own API integration (PCI scope). Card information for secure payment processing. All card data is automatically tokenized and encrypted before processing. Your card details are never stored or transmitted in plain text.

threeDsSuccessUrl

object

PCI / server-to-server only — For merchants who transmit card data via their API. URL to redirect to after successful 3DS authentication.

threeDsFailureUrl

object

PCI / server-to-server only — For merchants who transmit card data via their API. URL to redirect to after failed 3DS authentication.

firstName

object

Optional. Updates the customer's first name on file. When the customer has no name, the checkout form collects it from the buyer before 3DS.

lastName

object

Optional. Updates the customer's last name on file. When the customer has no name, the checkout form collects it from the buyer before 3DS.

Responses

Language

Credentials

Header

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Setup request created successfully. Use the returned id as setupId in the iframe SDK.

400Invalid input data or customer not found

401Unauthorized - Invalid API key