Developer Docs

Create a payment in the server to server process

post
https://api.inflowpay.com/api/server/payment

ℹ️ Note: To transmit card information directly through this API (server-to-server), replace the default base URL with https://api-card.inflowpay.com — contact support to get the required authorization.

If you are not transmitting card information directly (e.g. you're using our SDK to collect card details), keep the default base URL.

Creates a new payment transaction using card details. Product prices are excluding tax (HT).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
card
object

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. Ignored if useCustomerPaymentMethod is true.

products
array of objects

The list of inline products to purchase. All prices are excluding tax (HT). The total amount will be calculated based on the sum of product prices times quantities, then tax will be added automatically based on the billing country. Provide either products or items, not both.

products
items
array of objects

The list of catalog references to purchase (priceId or productId + quantity), resolved against your catalog. Provide either products or items, not both.

items
string
enum
required

Payment currency

Allowed:
string
required

Customer email address

savePaymentMethod
object
required

Whether to save the payment method. Cannot be used if useCustomerPaymentMethod is true.

useCustomerPaymentMethod
object
required

Whether to use the last saved customer payment method. Cannot be used if savePaymentMethod is true.

customerPaymentMethodId
object

Specific saved payment method to charge, scoped to the customer and the payment currency. Only used when useCustomerPaymentMethod is true. Defaults to the customer's default payment method for the currency if omitted.

offSession
object

Off-session payment (payer absent), Merchant Initiated. Requires a saved payment method (useCustomerPaymentMethod) and that the merchant is allowed to use off-session payments. Cannot be combined with force3ds or with card information.

force3ds
object

Force an on-session (payer present) 3DS browser challenge. With card information the 3DS is forced even if it would not normally be required. With useCustomerPaymentMethod the browser 3DS is performed before charging. Cannot be combined with offSession.

string
required

Billing country code (ISO 3166-1 alpha-2)

postalCode
object

Billing postal code (required for some countries like US)

boolean
required

Whether the purchase is for a business

businessName
object
required

Business name (required if purchasingAsBusiness is true)

taxId
object
required

Business tax ID (required if purchasingAsBusiness is true)

firstName
object

First name, is optional but can cause issues with the 3DS authentication if not provided

lastName
object

Last name, is optional but can cause issues with the 3DS authentication if not provided

metadatas
object

Optional metadata (key-value pairs)

autoConfirm
object

Auto-confirm the payment (default false). When enabled, the payment is processed immediately if no 3DS step is required, or right after a successful 3DS authentication.

string
enum
Defaults to TAX_EXCLUSIVE

Pricing mode for the products. TAX_EXCLUSIVE (default): Product prices are excluding tax (HT), tax is added on top to calculate the final amount. TAX_INCLUSIVE: Product prices include tax (TTC), tax is extracted from the total while keeping the final amount fixed.

Allowed:
threeDsSuccessUrl
object

URL to redirect to after successful 3DS authentication, only required if card information is provided

threeDsFailureUrl
object

URL to redirect to after failed 3DS authentication, only required if card information is provided

number

Connect only: explicit marketplace take on this payin in cents. Only the parent marketplace may set this for sub-merchant payins (X-On-Behalf-Of). When omitted, the marketplace default from settings applies at checkout success.

string
enum
Defaults to AUTOMATIC

Capture mode for card payments. AUTOMATIC (default): funds are captured when the customer pays. MANUAL: funds are authorized at checkout and must be captured later via POST /api/payment/:paymentId/capture (full amount only).

Allowed:
string

Optional statement descriptor (max 11 characters) shown on the customer's bank statement as 'INFLOWPAY* '. Falls back to the account-level statement descriptor if omitted.

Responses

Updated about 1 month ago

Did this page help you?
Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 1 month ago

Did this page help you?