curl --request POST \
  --url https://mercy-pay.com/api/v1/payment_links \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Formation Laravel",
  "pricing_mode": "options",
  "price_options": [
    {
      "label": "Solo",
      "amount": 100000
    },
    {
      "label": "Équipe de 5",
      "amount": 400000
    }
  ],
  "custom_fields_schema": [
    {
      "id": "company",
      "type": "text",
      "label": "Entreprise",
      "required": true
    }
  ],
  "collect_phone": true,
  "max_uses": 30
}
'

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://mercy-pay.com/api/v1/payment_links",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => 'Formation Laravel',
    'pricing_mode' => 'options',
    'price_options' => [
        [
                'label' => 'Solo',
                'amount' => 100000
        ],
        [
                'label' => 'Équipe de 5',
                'amount' => 400000
        ]
    ],
    'custom_fields_schema' => [
        [
                'id' => 'company',
                'type' => 'text',
                'label' => 'Entreprise',
                'required' => true
        ]
    ],
    'collect_phone' => true,
    'max_uses' => 30
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    title: 'Formation Laravel',
    pricing_mode: 'options',
    price_options: [{label: 'Solo', amount: 100000}, {label: 'Équipe de 5', amount: 400000}],
    custom_fields_schema: [{id: 'company', type: 'text', label: 'Entreprise', required: true}],
    collect_phone: true,
    max_uses: 30
  })
};

fetch('https://mercy-pay.com/api/v1/payment_links', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://mercy-pay.com/api/v1/payment_links"

payload = {
    "title": "Formation Laravel",
    "pricing_mode": "options",
    "price_options": [
        {
            "label": "Solo",
            "amount": 100000
        },
        {
            "label": "Équipe de 5",
            "amount": 400000
        }
    ],
    "custom_fields_schema": [
        {
            "id": "company",
            "type": "text",
            "label": "Entreprise",
            "required": True
        }
    ],
    "collect_phone": True,
    "max_uses": 30
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "id": "plink_2d8f4b6a1c3e4a5f9b7d8e0f2a4c6b18",
    "object": "payment_link",
    "livemode": false,
    "created": "2026-11-07T09:00:00+00:00",
    "type": "one_time",
    "pricing_mode": "options",
    "title": "Formation Laravel",
    "description": "Deux jours en présentiel à Yaoundé",
    "amount": null,
    "minimum_amount": null,
    "currency": "XAF",
    "price_options": [
      {
        "id": 31,
        "label": "Solo",
        "amount": 100000
      },
      {
        "id": 32,
        "label": "Équipe de 5",
        "amount": 400000
      }
    ],
    "items": [],
    "custom_fields": [
      {
        "id": "company",
        "type": "text",
        "label": "Entreprise",
        "required": true
      }
    ],
    "collect_phone": true,
    "collect_address": false,
    "after_payment_message": "Merci, vous recevrez vos accès par e-mail.",
    "is_active": true,
    "max_uses": 30,
    "uses_count": 12,
    "views_count": 240,
    "expires_at": null,
    "archived_at": null,
    "success_url": null,
    "cancel_url": null,
    "metadata": {
      "course": "laravel"
    },
    "url": "https://mercy-pay.com/payer/k3j9x2pq"
  }
}

{
  "error": {
    "type": "authentication_error",
    "code": "api_key_invalid",
    "message": "Clé API invalide.",
    "param": null,
    "doc_url": "https://docs.mercy-pay.com/developers/errors#api_key_invalid",
    "request_id": "req_01jc8x4m2v7t9qk3n5w6y8z0ab"
  }
}

{
  "error": {
    "type": "authentication_error",
    "code": "live_mode_requires_kyc",
    "message": "Le mode live demande un KYC approuvé.",
    "param": null,
    "doc_url": "https://docs.mercy-pay.com/developers/errors#live_mode_requires_kyc",
    "request_id": "req_01jc8x4m2v7t9qk3n5w6y8z0ab"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "conflict",
    "message": "Cette ressource est utilisée : archivez-la.",
    "param": null,
    "doc_url": "https://docs.mercy-pay.com/developers/errors#conflict",
    "request_id": "req_01jc8x4m2v7t9qk3n5w6y8z0ab"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "validation_failed",
    "message": "Le champ amount est obligatoire.",
    "param": "amount",
    "doc_url": "https://docs.mercy-pay.com/developers/errors#validation_failed",
    "request_id": "req_01jc8x4m2v7t9qk3n5w6y8z0ab",
    "errors": {
      "amount": [
        "Le champ amount est obligatoire."
      ]
    }
  }
}

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limited",
    "message": "Trop de requêtes.",
    "param": null,
    "doc_url": "https://docs.mercy-pay.com/developers/errors#rate_limited",
    "request_id": "req_01jc8x4m2v7t9qk3n5w6y8z0ab"
  }
}