Skip to content

Create Payment Intent​

POST
/bridge-payment/payments/intents

Create a new payment intent with intelligent pricing calculation. Supports both authenticated users and guest checkout. The system automatically calculates missing pricing fields (subtotal, tax, discount, total) based on provided values.

Authorizations​

SessionAuth

Session ID from Flowless authentication

TypeAPI Key (header: X-Session-ID)
or
GuestToken

Guest token for anonymous checkout

TypeAPI Key (query: token)
or

Request Body​

application/json
JSON
{
"subtotal_cents": 5000,
"tax_cents": 500,
"discount_cents": 0,
"total_cents": 5500,
"currency": "USD",
"concept": "Product Purchase",
"description": "Purchase of premium subscription",
"provider_id": "stripe",
"payment_method_id": "pm_1234567890",
"return_url": "https://example.com/payment/success",
"metadata": {
"additionalProperties": "string"
},
"guest_data": {
"email": "[email protected]",
"name": "John Doe",
"phone": "+1234567890"
},
"reference_code": "donation_general",
"category": "donation",
"tags": "recurring,premium"
}

Responses​

Payment intent created successfully

application/json
JSON
{
"success": true,
"data": {
"id": "pay_1234567890",
"client_secret": "pi_xxx_secret_yyy",
"amount_cents": 5500,
"currency": "USD",
"status": "requires_payment_method",
"provider_id": "stripe",
"created_at": "string"
}
}

Playground​

Server
Authorization
Body

Samples​

Powered by VitePress OpenAPI