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, a custom reference, and optionally pre-fill the customer's KYC data (payerDetails).

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

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.

Compliance Form & Payer Details

Due to regulatory requirements, basic identification data is required before a transaction can be initiated. You can streamline this process by passing the payerDetails object in your request. If provided, the Compliance Form is pre-filled, allowing the user to simply verify or edit their data before moving to the final payment screen, significantly reducing friction.

Manual Payment Logic

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

Rate Lock Agreement: After choosing the payment method, the user selects their preferred cryptocurrency and network. They must explicitly agree to lock the exchange rate for a set period (e.g., 10 minutes) before proceeding to the compliance form.

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

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

Web3 / Automated Payment

Using MetaMask or WalletConnect streamlines the process. The user fills out the Compliance Form first, and then the external application handles the transaction details automatically. A standard rate lock agreement is not required here, as the payment is registered immediately upon confirmation in the wallet app.

Automatic Settlement

Partners do not need to manage cryptocurrency volatility. After the required blockchain confirmations, 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

🟠404P479: Payment link not found

🟢200P482: Country is not supported

curl --location 'https://partner-api-stage.fintegence.io/v1/payment-link' \ --header 'x-api-key: <api-key>' \ --header 'Content-Type: application/json' \ --data-raw '{ "amount": "150.50", "expiresAt": "2026-06-30T12:00:00Z", "reference": "example_ref", "note": "example_note", "payerDetails": { "type": "PERSONAL", "email": "john.doe@example.com", "firstName": "John", "lastName": "Doe", "birthDate": "1990-05-20T00:00:00Z", "residenceCountry": "US", "birthPlace": "GB", "phoneNumber": "+1234567890" } }'

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

Generate Payment Link

Overview#

Payment Process Flow#

Key Integration Details#

Link Expiration (expiresAt)#

Compliance Form & Payer Details#

Manual Payment Logic#

Web3 / Automated Payment#

Automatic Settlement#

Request