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: 3ce560cc-4d42-4543-b9ef-8cc35c00638c

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": "3ce560cc-4d42-4543-b9ef-8cc35c00638c",
  "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": "3ce560cc-4d42-4543-b9ef-8cc35c00638c",
    "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/6a42622f-4968-47e2-a24d-5f5f1dc1acd6"
  }
}