Generate Payment Link

This endpoint generates a Standard Payment Link using the global P100 configuration. It allows you to collect payments in various cryptocurrencies, which are then automatically converted and settled to your balance in EUR.

Overview

Request: Provide the amount, expiration date, and a custom reference.

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

Settlement: Once the transaction is confirmed on the blockchain, the funds are swapped to EUR and credited to your account.

Payment Process Flow

Key Integration Details

1. Link Expiration (`expiresAt`)

The expiresAt parameter defines the total lifetime of the payment link. For example, if set to 3 months from now, the user will not be able to access the payment page after that period.

2. Compliance Form

Due to regulatory requirements, every user must provide basic identification data (Name, Email, etc.) after selecting their payment method but before the transaction is initiated.

3. Manual Payment Logic

The parameters governing manual payments are highly configurable via the P100 system to suit specific partner requirements:

Rate Lock: When a user selects a specific cryptocurrency, the exchange rate is locked for a set period (e.g., 10 minutes). The user must broadcast the transaction within this window.

Note: The duration of the Rate Lock is configurable.

Underpayment: If the user sends less than the required amount, they are granted a grace period (e.g., 2 hours) to pay the remaining balance.

Note: Both the duration of the grace period and the underpayment tolerance thresholds are configurable.

Overpayment: If the user overpays, the payment is processed, but it is flagged for manual review to handle the refund of the excess amount.

4. Web3 / Automated Payment

Using MetaMask or WalletConnect streamlines the process. The external application handles the transaction details automatically. In this flow, a rate lock is not required as the payment is registered immediately upon the user's confirmation in their wallet app.

5. Automatic Settlement

Partners do not need to manage cryptocurrency volatility. After the required blockchain confirmations (the number of which is configurable based on the asset and network), 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

🟠404P479: Payment link not found

curl --location --request POST 'https://partner-api-stage.p100.io/v1/payment-link' \ --header 'x-api-key: <api-key>' \ --header 'Content-Type: application/json' \ --data-raw '{ "amount": "2", "expiresAt": "2026-05-31T21:21:35.840Z", "reference": "example_ref_123", "note": "example_note" }'

{ "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 Payment Link

Overview#

Payment Process Flow#

Key Integration Details#

1. Link Expiration (expiresAt)#

2. Compliance Form#

3. Manual Payment Logic#

4. Web3 / Automated Payment#

5. Automatic Settlement#

Request