Generate Hosted Checkout

This endpoint generates a Hosted Checkout Link tailored specifically to your dedicated Partner configuration. Unlike the Standard Payment Link, this version bypasses global P100 settings to apply your specific business rules and brand identity.

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

Onboarding Required

Hosted Checkout is a feature that requires manual setup. To enable this experience - including your custom logo, specific Lock Rate Durations, and Underpayment Windows - please contact our support team for configuration before using this endpoint.

How it works

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

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

Payment: The user completes the payment on a branded page.

Return: Upon successful payment, a confirmation screen is shown with a button that redirects the user back to your specified redirectUrl.

Payment Process Flow

Key Integration Details

White-label Configuration

The Hosted Checkout is fully customizable via the P100 back-office. During onboarding, we configure your custom branding (logo, colors), custom lock rates for exchange guarantees, and specific timeframes for underpayment windows.

Return Path (redirectUrl)

The redirectUrl is the destination where your customer will be sent after the payment is finalized. Once the payment is successful, the user is presented with a branded success screen containing a prominent return button. Clicking this button redirects the user to your provided URL, allowing you to land them back on a "Thank You" or "Order Status" page on your platform.

Compliance & Pre-filled Payer Details

P100 handles all regulatory requirements (KYT/AML). The Compliance Form is mandatory, appearing after the user agrees to the rate lock (manual path) or right after selecting a Web3 wallet. By providing the payerDetails object during the initial request, you can pre-fill this data. The user can simply review or edit the fields if necessary, providing a frictionless checkout experience within your branded flow.

Payment Logic & Settlement

Users must explicitly accept the custom Rate Lock terms before proceeding to the compliance and payment screens. We manage all cryptocurrency volatility risks from that point forward. Once the required blockchain confirmations are reached, the system instantly converts the crypto to EUR and credits it to 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://partner-api-stage.p100.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": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "currencySlug": "string", "amount": 0, "reference": "string", "expiresAt": "2019-08-24T14:15:22.123Z", "url": "http://example.com" }

Generate Hosted Checkout

How it works#

Payment Process Flow#

Key Integration Details#

White-label Configuration#

Return Path (redirectUrl)#

Compliance & Pre-filled Payer Details#

Payment Logic & Settlement#

Request