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

/api-gateway/recurrents/create-subscriber-billing-link

Header parameters

x-api-public-keystring

Public API-key

x-api-signaturestring

Signing the request body with a private API-key

Content-typestring

Request content type

Example: application/json

Body

merchantIdstringrequired

Merchant ID in the system

Example: 41fe615a-96dc-42c2-9629-196383411cd4

clientIdstringrequired

Client ID in the merchant system

Example: merchant_client_unique_id

clientEmailstringrequired

Client's mail in the merchant's system

Example: [e-mail]

clientNamestring

Client name in the merchant system

Example: John Doe

returnUrlstring

URL to be used as "Return to Store" link

Example: https://merchant.domain/

webhookUrlstring

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

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

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://ocp.onchainpay.io/api-gateway/recurrents/create-subscriber-billing-link' \
  --header 'Content-Type: application/json' \
  --data '{"merchantId":"41fe615a-96dc-42c2-9629-196383411cd4","clientId":"merchant_client_unique_id","clientEmail":"[e-mail]","clientName":"John Doe","returnUrl":"https://merchant.domain/","webhookUrl":"https://merchant.domain/webhooks/subscription"}'

200

200

{
  "success": true,
  "response": {
    "merchantId": "41fe615a-96dc-42c2-9629-196383411cd4",
    "clientId": "merchant_client_unique_id",
    "clientEmail": "[e-mail]",
    "clientName": "John Doe",
    "returnUrl": "https://merchant.domain/",
    "webhookUrl": "https://merchant.domain/webhooks/subscription",
    "link": "https://subscriptions.domain/60b5c367-1b93-448a-b08a-16da458102b5"
  }
}