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 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

string

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

threeDsFailureUrl

string

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

firstName

string

Optional in the API schema, but required when the customer has no first name on file (e.g. new customers) or when that data is missing — 3DS cannot be started without it.

lastName

string

Optional in the API schema, but required when the customer has no last name on file (e.g. new customers) or when that data is missing — 3DS cannot be started without it.

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