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 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, and your redirectUrl.

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

1. White-label Configuration

The Hosted Checkout is fully customizable via the P100 back-office. During onboarding, we configure:

Custom Branding: Your company logo and brand colors.

Custom Lock Rates: Configurable duration for exchange rate guarantees (e.g., 15, 30 min).

Underpayment Windows: Configurable timeframes for users to complete partial payments.

2. Return Path (`redirectUrl`)

The redirectUrl is the destination where your customer will be sent after the payment is finalized.

User Experience: Once the payment is successful and confirmed, the user is presented with a success screen.

Action: A prominent button (e.g., "Return to [Partner Name]") is displayed. Clicking this button redirects the user to your provided URL.

Integration: Use this URL to land the user back on a "Thank You" or "Order Status" page on your platform.

3. Compliance & Security

P100 handles all regulatory requirements (KYT/AML). The Compliance Form (Step 5) is mandatory to ensure legal compliance, but it is integrated seamlessly into your branded checkout flow.

4. Automatic Settlement

We manage all cryptocurrency volatility risks. 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

Body

🟠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

curl --location --request POST 'https://partner-api-stage.p100.io/v1/hosted-checkout' \ --header 'x-api-key: <api-key>' \ --header 'Content-Type: application/json' \ --data-raw '{ "amount": "10", "expiresAt": "2026-02-30T21:21:35.840Z", "reference": "example_ref_123", "note": "example_note", "redirectUrl": "https://example.com" }'

{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "currencySlug": "string", "amount": 0, "reference": "string", "expiresAt": "2019-08-24T14:15:22.123Z", "note": "string", "url": "http://example.com" }

Generate Hosted Checkout

How it works#

Payment Process Flow#

Key Integration Details#

1. White-label Configuration#

2. Return Path (redirectUrl)#

3. Compliance & Security#

4. Automatic Settlement#

Request