Creating a payment link

The method creates a temporary link to connect the user. The user must follow the link and give permission to spend coins from his address. After that, you will receive a webhook with the status and payment link ID

Creating a payment link

post

Header parameters

x-api-public-keystringOptional

Public API-key

x-api-signaturestringOptional

Signing the request body with a private API-key

Content-typestringOptional

Request content type

Example: application/json

Body

The body of the request to create a link to connect the user

merchantIdstringRequired

Merchant ID in the system

Example: 3ef22c52-c364-4acd-941d-5940f647a4f1

clientIdstringRequired

Client ID in the merchant system

Example: merchant_client_unique_id

clientEmailstringRequired

Client's mail in the merchant's system

Example: [email protected]

clientNamestringOptional

Client name in the merchant system

Example: John Doe

returnUrlstringOptional

URL to be used as "Return to Store" link

Example: https://merchant.domain/

webhookUrlstringOptional

URL to notify about connecting or denying a client's connection request

Example: https://merchant.domain/webhooks/subscription

Responses

200Success

application/json

post

HTTPcURLJavaScriptPython

POST /api-gateway/recurrents/create-subscriber-billing-link HTTP/1.1
Host: ocp.onchainpay.io
Content-Type: application/json
Accept: */*
Content-Length: 257

{
  "merchantId": "3ef22c52-c364-4acd-941d-5940f647a4f1",
  "clientId": "merchant_client_unique_id",
  "clientEmail": "[email protected]",
  "clientName": "John Doe",
  "returnUrl": "https://merchant.domain/",
  "webhookUrl": "https://merchant.domain/webhooks/subscription"
}

200Success

{
  "success": true,
  "response": {
    "merchantId": "3ef22c52-c364-4acd-941d-5940f647a4f1",
    "clientId": "merchant_client_unique_id",
    "clientEmail": "[email protected]",
    "clientName": "John Doe",
    "returnUrl": "https://merchant.domain/",
    "webhookUrl": "https://merchant.domain/webhooks/subscription",
    "link": "https://subscriptions.domain/c7358087-4e45-44b7-8de2-427621f2eaf4"
  }
}