Generate Hosted Checkout

Generates a Hosted Checkout Link tailored to your dedicated Partner configuration. Unlike the Standard Payment Link, this version uses your partner-specific business rules and brand identity.

This ensures a seamless white-label experience where customers interact with an interface that reflects your logo and custom parameters, maintaining brand consistency throughout the payment process.

Onboarding Required

Hosted Checkout requires manual setup. To enable this experience, including your custom logo, specific Lock Rate Durations, and Underpayment Windows, contact Fintegence support for configuration before using this endpoint.

How It Works

Request: Send a POST request with amount, expiration, your redirectUrl, and optional payerDetails.

Redirect: Send your customer to the unique URL returned in the response.

Payment: The user completes payment on a branded page.

Return: After successful payment, a confirmation screen is shown with a button redirecting the user to your redirectUrl.

Payment Process Flow

Key Integration Details

White-label Configuration

Hosted Checkout is customizable via partner configuration set during onboarding: branding (logo/colors), custom lock rate durations, and underpayment window rules.

Return Path (`redirectUrl`)

redirectUrl is the destination where the customer is sent after payment finalization. After success, the user sees a confirmation page with a return button that redirects to your provided URL.

Compliance and Pre-filled Payer Details

Fintegence handles compliance requirements (KYT/AML). The Compliance Form is mandatory: after rate lock confirmation in manual flow, or immediately after Web3 wallet selection. If payerDetails is provided, fields are pre-filled and can be reviewed/edited by the user.

Payment Logic and Settlement

Users accept custom rate lock terms before proceeding. After required blockchain confirmations, the system converts crypto to EUR and credits your Partner Balance.

Responses

🟢201Success

application/json

Bodyapplication/json

🟠401Access Denied

🟠400P403: Validation error

🟠400P477: Payment link amount exceeds maximum allowed

🟠400P478: Payment link expires at is too far in the future

🟠400P500: Unknown exception

🟠400P501: Service temporarily unavailable

🟠400P476: Configuration missing

🟠404P479: Payment link not found

🟢200P482: Country is not supported

curl --location 'https://stage-api.fintegence.io/v1/hosted-checkout' \ --header 'x-api-key: <api-key>' \ --header 'Content-Type: application/json' \ --data-raw '{ "amount": "250.00", "expiresAt": "2026-07-15T10:00:00Z", "reference": "example_ref", "redirectUrl": "https://your-store.com/checkout/success", "payerDetails": { "email": "jane.smith@example.com", "firstName": "Jane", "lastName": "Smith", "birthDate": "1988-11-12T00:00:00Z", "residenceCountry": "CA", "birthPlace": "FR", "phoneNumber": "+1987654321" } }'

{ "id": "c415f9d7-1fa4-48cd-ab4a-5e2dadb41616", "currencySlug": "eur", "amount": 250, "reference": "example_ref", "expiresAt": "2026-07-15T10:00:00.000Z", "url": "https://web.fintegence.io/payment-link/c415f9d7-1fa4-48cd-ab4a-5e2dadb41616" }

Generate Hosted Checkout

How It Works#

Payment Process Flow#

Key Integration Details#

White-label Configuration#

Return Path (redirectUrl)#

Compliance and Pre-filled Payer Details#

Payment Logic and Settlement#

Request