การสร้างการชำระเงินแบบประจำ

การชำระเงินแบบต่อเนื่องในสกุลเงินดิจิทัลเป็นวิธีหนึ่งในการดำเนินธุรกรรมปกติโดยอัตโนมัติโดยใช้สินทรัพย์ดิจิทัล ซึ่งสามารถนำไปใช้ประโยชน์ได้กับบริการแบบสมัครสมาชิก การบริจาค การเป็นสมาชิก และการชำระเงินแบบต่อเนื่องอื่นๆ

ในการใช้การชำระเงินแบบต่อเนื่อง คุณต้องสร้างการชำระเงินที่ระบุจำนวนเงิน สกุลเงิน และความถี่ในการชำระเงิน จากนั้นแชร์ข้อมูลดังกล่าวกับผู้ชำระเงินของคุณ ผู้ชำระเงินจะถูกนำไปยังเว็บไซต์ของ cryptomus ซึ่งจะต้องเข้าสู่ระบบเพื่อยืนยันแผนการชำระเงินและชำระเงินครั้งแรก หลังจากนั้น การชำระเงินจะดำเนินการโดยอัตโนมัติตามแผนการชำระเงิน


post https://api.cryptomus.com/v1/recurrence/create สำเนา

ขอ

พารามิเตอร์การค้นหา

ชื่อประเภทพารามิเตอร์ค่าเริ่มต้นคำนิยาม
amount*string-จำนวนเงินที่ต้องชำระซ้ำ
currency*string-รหัสสกุลเงิน
name*stringmin:3max:60-ชื่อการชำระเงินที่เกิดขึ้นซ้ำ
period*string-ระยะเวลาการชำระเงินซ้ำมีอยู่:weeklymonthlythree_month
to_currency-รหัสสกุลเงินสำหรับการรับชำระเงินพารามิเตอร์นี้ใช้เพื่อระบุสกุลเงินเป้าหมายสำหรับการแปลงจำนวนเงินการชำระเงินซ้ำตัวอย่างเช่น การสร้างการชำระเงินซ้ำสำหรับ 20 USD ใน bitcoin:
จำนวนเงิน: 20
สกุลเงิน: USD
to_currency: BTCAPI จะแปลงจำนวนเงิน 20 USD เป็น BTC ที่เทียบเท่าตามอัตราแลกเปลี่ยนปัจจุบัน และผู้ใช้จะชำระเงินเป็น BTCto_currency ควรเป็นรหัสสกุลเงินดิจิทัลเสมอ ไม่ใช่รหัสสกุลเงินทั่วไป
order_idstringmin:1max:100nullรหัสคำสั่งซื้อในระบบของคุณ
url_callbackurlnullURL ที่จะส่งเว็บฮุกพร้อมสถานะการชำระเงิน
discount_daysintegermin:1max:3650วันระยะเวลาส่วนลด (จำเป็นสำหรับ 'discount_amount')
discount_amountstringnullจำนวนส่วนลด (จำเป็นสำหรับ 'discount_days') ที่นี่คือจำนวนเงินในสกุลเงินของพารามิเตอร์ 'currency'
additional_datastringnullรายละเอียดการชำระเงินซ้ำเพิ่มเติม

ประเภทพารามิเตอร์

string

คำนิยาม

จำนวนเงินที่ต้องชำระซ้ำ

ประเภทพารามิเตอร์

string

คำนิยาม

รหัสสกุลเงิน

ประเภทพารามิเตอร์

stringmin:3max:60

คำนิยาม

ชื่อการชำระเงินที่เกิดขึ้นซ้ำ

ประเภทพารามิเตอร์

string

คำนิยาม

ระยะเวลาการชำระเงินซ้ำมีอยู่:weeklymonthlythree_month

คำนิยาม

รหัสสกุลเงินสำหรับการรับชำระเงินพารามิเตอร์นี้ใช้เพื่อระบุสกุลเงินเป้าหมายสำหรับการแปลงจำนวนเงินการชำระเงินซ้ำตัวอย่างเช่น การสร้างการชำระเงินซ้ำสำหรับ 20 USD ใน bitcoin:
จำนวนเงิน: 20
สกุลเงิน: USD
to_currency: BTCAPI จะแปลงจำนวนเงิน 20 USD เป็น BTC ที่เทียบเท่าตามอัตราแลกเปลี่ยนปัจจุบัน และผู้ใช้จะชำระเงินเป็น BTCto_currency ควรเป็นรหัสสกุลเงินดิจิทัลเสมอ ไม่ใช่รหัสสกุลเงินทั่วไป

ประเภทพารามิเตอร์

stringmin:1max:100

ค่าเริ่มต้น

null

คำนิยาม

รหัสคำสั่งซื้อในระบบของคุณ

ประเภทพารามิเตอร์

url

ค่าเริ่มต้น

null

คำนิยาม

URL ที่จะส่งเว็บฮุกพร้อมสถานะการชำระเงิน

ประเภทพารามิเตอร์

integermin:1max:365

ค่าเริ่มต้น

0

คำนิยาม

วันระยะเวลาส่วนลด (จำเป็นสำหรับ 'discount_amount')

ประเภทพารามิเตอร์

string

ค่าเริ่มต้น

null

คำนิยาม

จำนวนส่วนลด (จำเป็นสำหรับ 'discount_days') ที่นี่คือจำนวนเงินในสกุลเงินของพารามิเตอร์ 'currency'

ประเภทพารามิเตอร์

string

ค่าเริ่มต้น

null

คำนิยาม

รายละเอียดการชำระเงินซ้ำเพิ่มเติม

* - พารามิเตอร์บังคับ

การลดราคา:

ช่วงเวลาแรกเป็นวัน (พารามิเตอร์ discount_days) ซึ่งจะมีค่าใช้จ่ายที่แตกต่างกัน (พารามิเตอร์ discount_amount) ตัวอย่างเช่น คุณสามารถตั้งค่า discount_amount สำหรับ 30 วันแรกและช่วงเวลารายเดือน จากนั้นผู้ใช้จะชำระเงินงวดแรกในราคาที่ต่ำกว่า ส่วนงวดที่สองและงวดต่อๆ ไปจะชำระเต็มราคา

จำนวนส่วนลดจะต้องเป็นสกุลเงินที่ระบุโดยพารามิเตอร์ 'สกุลเงิน'

ขอตัวอย่าง

ด้านล่างนี้คือตัวอย่างพร้อมจำนวนพารามิเตอร์ขั้นต่ำที่จำเป็น ในกรณีนี้ ระบบจะสร้างใบแจ้งหนี้โดยใช้สกุลเงินเฟียต USD ในหน้าการชำระเงิน ผู้ใช้จะสามารถเลือกสกุลเงินดิจิทัลและเครือข่ายเพื่อชำระบิลนี้ได้


curl https://api.cryptomus.com/v1/recurrence/create \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{
	"amount": "15",
	"currency": "USDT",
	"name": "Recurring payment",
	"period": "monthly"
}'
สำเนา

การตอบสนอง

พารามิเตอร์การตอบสนอง

ชื่อคำนิยาม
uuidUUID ที่เกิดขึ้นซ้ำ
nameชื่อที่เกิดซ้ำ
order_idรหัสคำสั่งซื้อในระบบของคุณ
amountจำนวนเงินที่เกิดขึ้นซ้ำ
currencyรหัสสกุลเงิน
payer_currencyสกุลเงินที่ลูกค้าจะต้องใช้ชำระเงิน
payer_amount_usdจำนวนเงินเทียบเท่า USD ใน payer_currency ที่ลูกค้าจะต้องชำระ
payer_amountจำนวนเงินใน payer_currency ที่ลูกค้าจะต้องชำระ
url_callbackURL ที่จะส่งเว็บฮุกพร้อมสถานะการชำระเงิน
periodระยะเวลาการชำระเงินซ้ำ
statusสถานะที่เกิดขึ้นซ้ำตัวเลือกที่มี:• wait_accept• cancel_by_merchant• active• cancel_by_user
urlURL ของหน้าการชำระเงิน Cryptomus ที่ผู้ชำระเงินจะทำการชำระเงิน
last_pay_offวันที่ชำระเงินครั้งสุดท้าย โซนเวลาคือ UTC+3 หากค่าเป็น null แสดงว่าไม่มีการชำระเงินเกิดขึ้น
additional_dataรายละเอียดการชำระเงินซ้ำเพิ่มเติม

คำนิยาม

UUID ที่เกิดขึ้นซ้ำ

คำนิยาม

ชื่อที่เกิดซ้ำ

คำนิยาม

รหัสคำสั่งซื้อในระบบของคุณ

คำนิยาม

จำนวนเงินที่เกิดขึ้นซ้ำ

คำนิยาม

รหัสสกุลเงิน

คำนิยาม

สกุลเงินที่ลูกค้าจะต้องใช้ชำระเงิน

คำนิยาม

จำนวนเงินเทียบเท่า USD ใน payer_currency ที่ลูกค้าจะต้องชำระ

คำนิยาม

จำนวนเงินใน payer_currency ที่ลูกค้าจะต้องชำระ

คำนิยาม

URL ที่จะส่งเว็บฮุกพร้อมสถานะการชำระเงิน

คำนิยาม

ระยะเวลาการชำระเงินซ้ำ

คำนิยาม

สถานะที่เกิดขึ้นซ้ำตัวเลือกที่มี:- wait_accept- cancel_by_merchant- active- cancel_by_user

คำนิยาม

URL ของหน้าการชำระเงิน Cryptomus ที่ผู้ชำระเงินจะทำการชำระเงิน

คำนิยาม

วันที่ชำระเงินครั้งสุดท้าย โซนเวลาคือ UTC+3 หากค่าเป็น null แสดงว่าไม่มีการชำระเงินเกิดขึ้น

คำนิยาม

รายละเอียดการชำระเงินซ้ำเพิ่มเติม

ตัวอย่างการตอบกลับ

หากคำขอสำเร็จ รหัสตอบกลับคือ 200


1{
2	"state": 0,
3	"result": {
4		"uuid": "afd050e8-35ea-4129-bbdd-73f510dce556",
5		"name": "Recurring payment",
6		"order_id": null,
7		"amount": "15",
8		"currency": "USDT",
9		"payer_currency": "USDT",
10		"payer_amount_usd": "15.00",
11		"payer_amount": "15.00000000",
12		"url_callback": null,
13		"period": "monthly",
14		"status": "wait_accept",
15		"url": "https://pay.cryptomus.com/recurring/afd050e8-35ea-4129-bbdd-73f510dce556",
16		"last_pay_off": null
17	}
18}
สำเนา

ตัวอย่างเพิ่มเติม

ขอตัวอย่างข้อมูลเพื่อสร้างการชำระเงินซ้ำจำนวน 15 USD


1{
2	"amount": "15",
3	"currency": "USD",
4	"name": "Recurring payment",
5	"period": "monthly",
6	"url_callback": "https://your.site/callback"
7}
สำเนา

ตัวอย่างการตอบกลับ:


1{
2	"state": 0,
3	"result": {
4		"uuid": "1d4c1ef7-1dcd-4f98-9433-2e19d2e62820",
5		"name": "Recurring payment",
6		"order_id": null,
7		"amount": "15",
8		"currency": "USD",
9		"payer_currency": null,
10		"payer_amount_usd": "0.00",
11		"payer_amount": null,
12		"url_callback": "https://your.site/callback",
13		"period": "monthly",
14		"status": "wait_accept",
15		"url": "https://pay.cryptomus.com/recurring/1d4c1ef7-1dcd-4f98-9433-2e19d2e62820",
16		"last_pay_off": null
17	}
18}
สำเนา

ขอตัวอย่างข้อมูลเพื่อสร้างการชำระเงินแบบซ้ำจำนวน 15 USDT (อนุญาตให้ชำระเงินได้เฉพาะ USDT เท่านั้น)


1{
2	"amount": "15",
3	"currency": "USDT",
4	"name": "Recurring payment",
5	"period": "monthly",
6	"url_callback": "https://your.site/callback"
7}
สำเนา

ตัวอย่างการตอบกลับ:


1{
2	"state": 0,
3	"result": {
4		"uuid": "ec04dc64-fea4-445a-9698-59baa474317a",
5		"name": "Recurring payment",
6		"order_id": null,
7		"amount": "15",
8		"currency": "USDT",
9		"payer_currency": "USDT",
10		"payer_amount_usd": "15.00",
11		"payer_amount": "15.00000000",
12		"url_callback": "https://your.site/callback",
13		"period": "monthly",
14		"status": "wait_accept",
15		"url": "https://pay.cryptomus.com/recurring/ec04dc64-fea4-445a-9698-59baa474317a",
16		"last_pay_off": null
17	}
18}
สำเนา

ขอตัวอย่างข้อมูลเพื่อสร้างการชำระเงินซ้ำจำนวน 15 USD และอนุญาตให้ใช้สกุลเงิน BTC สำหรับการชำระเงินเท่านั้น


1{
2	"amount": "15",
3	"currency": "USD",
4	"to_currency": "BTC",
5	"name": "Recurring payment",
6	"period": "monthly",
7	"url_callback": "https://your.site/callback"
8}
สำเนา

ตัวอย่างการตอบกลับ:


1{
2	"state": 0,
3	"result": {
4		"uuid": "e7d9c265-3849-4ff8-84c1-15435368f05f",
5		"name": "Recurring payment",
6		"order_id": null,
7		"amount": "15",
8		"currency": "USD",
9		"payer_currency": "BTC",
10		"payer_amount_usd": "15.00",
11		"payer_amount": "0.00051495",
12		"url_callback": "https://your.site/callback",
13		"period": "monthly",
14		"status": "wait_accept",
15		"url": "https://pay.cryptomus.com/recurring/e7d9c265-3849-4ff8-84c1-15435368f05f",
16		"last_pay_off": null
17	}
18}
สำเนา

ขอตัวอย่างข้อมูลเพื่อสร้างการชำระเงินแบบประจำจำนวน 15 ดอลลาร์สหรัฐฯ โดย 30 วันแรกราคาจะอยู่ที่ 1 ดอลลาร์สหรัฐฯ หลังจากนั้นจะอยู่ที่ 15 ดอลลาร์สหรัฐฯ


1{
2	"amount": "15",
3	"currency": "USD",
4	"name": "Recurring payment",
5	"period": "monthly",
6	"discount_days": 30,
7  "discount_amount": "1"
8	"url_callback": "https://your.site/callback"
9}
สำเนา

ตัวอย่างการตอบกลับ:


1{
2	"state": 0,
3	"result": {
4		"uuid": "1ee00fbd-42e7-4653-b316-1ab12f8a447b",
5		"name": "Recurring payment",
6		"order_id": null,
7		"amount": "15",
8		"currency": "USD",
9		"payer_currency": null,
10		"payer_amount_usd": "0.00",
11		"payer_amount": null,
12		"url_callback": "https://your.site/callback",
13		"discount_days": "30",
14                "discount_amount": "1",
15		"end_of_discount": "2023-07-11T20:23:52+03:00",
16		"period": "monthly",
17		"status": "wait_accept",
18		"url": "https://pay.cryptomus.com/recurring/1ee00fbd-42e7-4653-b316-1ab12f8a447b",
19		"last_pay_off": null
20	}
21}
สำเนา