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: 09deae3d-2fc6-4d1e-bce4-c7aaac32261d

clientIdstringRequired

Client ID in the merchant system

Example: merchant_client_unique_id

clientEmailstringRequired

Client's mail in the merchant's system

Example: [e-mail]

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": "09deae3d-2fc6-4d1e-bce4-c7aaac32261d",
  "clientId": "merchant_client_unique_id",
  "clientEmail": "[e-mail]",
  "clientName": "John Doe",
  "returnUrl": "https://merchant.domain/",
  "webhookUrl": "https://merchant.domain/webhooks/subscription"
}

200Success

{
  "success": true,
  "response": {
    "merchantId": "09deae3d-2fc6-4d1e-bce4-c7aaac32261d",
    "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/d21932f9-e9a1-4307-91f1-4b61d5b3f821"
  }
}