Developer Docs

Create a payment in the server to server process

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

⚠️ WARNING: This endpoint is reserved for server-to-server integration only.
When transmitting card information, replace the default base URL with https://api-card.inflowpay.com. Please contact support to get the right authorization to proceed

If you are not intending to transmit card information, generally when you are using our SDK to transmit card information, use 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
required

The list of 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.

products*
string
enum
required

Payment currency

Allowed:
string
required

Customer email address

boolean

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

boolean

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

boolean

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.

boolean

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)

string

Billing postal code (required for some countries like US)

boolean
required

Whether the purchase is for a business

string

Business name (required if purchasingAsBusiness is true)

string

Business tax ID (required if purchasingAsBusiness is true)

string

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

string

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

metadatas
object

Optional metadata (key-value pairs)

boolean

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

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

string

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

number
≥ 0

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
length ≤ 11

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 2 months ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 2 months ago