Generate Payment Link

Developing

Testing Env

https://partner-api-stage.p100.io

POST

/v1/payment-link

This endpoint creates a payment link for customer deposits. Links are generated for a specified fiat amount (e.g., 100 EUR).

Workflow Description

Link Generation: You generate a payment link for a specific fiat value (e.g., 100 EUR). The API response will contain a URL.

Redirection: Redirect your user to the dedicated payment page to complete the payment, using the URL provided in the response.

Crypto Selection: On our payment page, your user selects which cryptocurrency they wish to pay with.

Payment Details: The page displays the required crypto amount (equivalent to the initial fiat value) and a destination wallet address for payment.

Status Updates: While the transaction is processed, we send webhooks to your system with status updates (e.g., pending, confirmed, failed).

If you need to retrieve current exchange rates before generating a link, use the Retrieve Exchange Rate endpoint.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

🟠400P403: Validation error

🟠400P500: Unknown exception

🟠400P501: Service temporarily unavailable

🟠401Access Denied

Request Example

Shell

JavaScript

Java

Swift

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": "123.45",
    "expiresAt": "2025-08-31T21:21:35.840Z",
    "reference": "example_ref_123"
}'

Response Example

200 - Success

{
    "paymentLinkId": "663318af-7ea1-4c5a-8545-e433a2d43d5c",
    "url": "https://p100-payment-link.io/123456789",
    "amount": "123.45",
    "expiresAt": "2025-08-31T21:21:35.840Z"
}

Payment link

Get Payment Link Details

Generate Payment Link

Workflow Description#

Request

Responses

Workflow Description