Generate Payment Link

Generates a Standard Payment Link using the global Fintegence standard configuration. It lets you collect payments in multiple cryptocurrencies, automatically converted and settled to your balance in EUR.

Overview

Request: Provide amount, expiration date, custom reference, and optionally pre-fill customer KYC data (payerDetails).

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

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

Payment Process Flow

Key Integration Details

Link Expiration (`expiresAt`)

expiresAt defines the total lifetime of the payment link. After this date, the payment page is no longer accessible.

Compliance Form and Payer Details

Due to regulatory requirements, basic identification data is required before payment can be initiated. If you pass payerDetails, the Compliance Form is pre-filled so the user can verify or edit data before payment, reducing friction.

Manual Payment Logic

Manual payment behavior is configurable via the Fintegence standard profile.

Rate Lock Agreement: After choosing payment method, the user selects cryptocurrency and network, then explicitly agrees to lock the rate for a defined window (e.g., 10 minutes).

Underpayment: If user sends less than required, they get a configurable grace period (e.g., 2 hours) to complete payment.

Overpayment: If user overpays, payment is accepted but flagged for manual review to handle excess refund.

Web3 and Automated Payment

With MetaMask or WalletConnect, the user completes the Compliance Form first, then wallet integration handles transfer details automatically. A separate rate lock agreement is typically not required in this path.

Automatic Settlement

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

🟠404P479: Payment link not found

🟢200P482: Country is not supported

curl --location 'https://stage-api.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": "46c4e2cd-1e19-4ef8-9033-fe0e5b14331f", "currencySlug": "eur", "amount": 150.5, "reference": "example_ref", "expiresAt": "2026-06-30T12:00:00.000Z", "note": "example_note", "url": "https://web.fintegence.io/payment-link/46c4e2cd-1e19-4ef8-9033-fe0e5b14331f" }

Generate Payment Link

Overview#

Payment Process Flow#

Key Integration Details#

Link Expiration (expiresAt)#

Compliance Form and Payer Details#

Manual Payment Logic#

Web3 and Automated Payment#

Automatic Settlement#

Request