لینک پرداخت
صفحه‌ای قابل اشتراک که بدون یک خط کد پرداخت می‌گیرد: قیمت ثابت یا مبلغی که پرداخت‌کننده وارد می‌کند، با فیلدهایی که شما می‌خواهید.
لینک پرداخت صفحه‌ای در bezanbecard.com/l/<slug> است که می‌توانید در چت بفرستید، به‌صورت کد QR چاپ کنید یا در بیوی اینستاگرام بگذارید. هر کسی که پرداخت می‌کند پرداخت مخصوص خودش را با مبلغ یکتای خودش می‌گیرد و بعد از همان صفحهٔ پرداخت همیشگی رد می‌شود: کارت‌به‌کارت یا با انتقال بانکی پرداخت می‌کند و رسید می‌فرستد و تیم شما تأییدش می‌کند.
لینک‌ها را در داشبورد از بخش لینک‌های پرداخت یا با API بسازید.
ساخت لینک
| پارامتر | توضیح |
|---|---|
title | الزامی. بالای صفحه نشان داده می‌شود. |
description | متن اختیاری زیر عنوان. |
amount | { "type": "fixed", "value": 5000000 }، یا برای مبلغی که پرداخت‌کننده انتخاب می‌کند { "type": "open", "min", "max", "presets" } (تا ۱۰ مبلغ پیشنهادی در همان بازه). |
collect | name، phone و email، هر کدام off، optional یا required. |
max_uses | بعد از این تعداد پرداخت موفق متوقف شود. |
expires_at | ثانیهٔ یونیکسی که بعد از آن لینک دیگر پرداخت نمی‌گیرد. |
after_completion | { "type": "message", "message" } که بعد از موفقیت پرداخت در پیام موفقیت نشان داده می‌شود، یا { "type": "redirect", "url" } برای فرستادن پرداخت‌کننده به سایت شما. |
card | کارت یا حساب مقصد پرداخت‌های این لینک، به‌جای روش تقسیم همیشگی. باید یکی از روش‌های پرداخت روشن شما را بپذیرد. |
metadata | کلیدهای دلخواه شما، مثل پرداخت‌ها. |
curl https://a.bezanbecard.com/v1/payment_links \
-H "Authorization: Bearer sk_test_…" \
-H "Idempotency-Key: link-workshop-1" \
-H "Content-Type: application/json" \
-d '{"title":"Workshop ticket","amount":{"type":"fixed","value":5000000},"collect":{"name":"required","phone":"required","email":"off"},"max_uses":40}'در مبلغ آزاد، min نباید از max بیشتر باشد (link_amount_range_invalid)؛ اگر بازه‌ای ندهید، همان سقف و کف پرداخت یعنی ۱۰٬۰۰۰ تا ۲٬۰۰۰٬۰۰۰٬۰۰۰ ریال به کار می‌رود.
پرداخت‌کننده چه می‌بیند
صفحهٔ لینک نام و لوگوی شما، عنوان، تصویر و توضیح، مبلغ یا فیلد مبلغ با پیشنهادهایش و فیلدهایی را که خواسته‌اید نشان می‌دهد. وقتی پرداخت‌کننده ادامه می‌دهد، یک پرداخت با source: "link" ساخته می‌شود و او به صفحهٔ پرداختش می‌رود. لینکی که نمی‌تواند پرداخت بگیرد دلیلش را می‌گوید: بایگانی شده، منقضی شده، ظرفیتش پر شده یا حساب شما فعلاً پرداخت نمی‌گیرد.
سقف استفاده
max_uses پرداخت‌های موفق و پرداخت‌هایی را که هنوز باز هستند می‌شمارد و همان لحظه‌ای که کسی پرداخت را شروع می‌کند بررسی می‌شود؛ پس دو نفر نمی‌توانند هم‌زمان آخرین جا را بگیرند. پرداختی که منقضی یا لغو شود جایش را پس می‌دهد. پولی که فرستاده شده دیگر قابل رد کردن نیست؛ برای همین واریز دیررسیده در مهلت اضافهٔ یک پرداخت لغوشده هنوز می‌تواند لینک را از سقفش رد کند.
صفحهٔ لینک در داشبورد تعداد استفاده و درآمد آن را نشان می‌دهد که از روی پرداخت‌های موفقش دوباره حساب می‌شود.
ویرایش و بایگانی
POST /v1/payment_links/:id هر فیلدی را تغییر می‌دهد. برای حذف card، max_uses یا expires_at مقدار null (یا رشتهٔ خالی) بفرستید و برای بایگانی لینک "active": false. لینک‌ها هیچ‌وقت حذف نمی‌شوند، چون پرداخت‌هایشان به آن‌ها اشاره می‌کنند.
تغییر لینک‌ها رویدادهای payment_link.created و payment_link.updated را می‌سازد و پرداخت‌هایشان همان رویدادهای همیشگی پرداخت را.