반복적 인 지불 생성

cryptocurrency의 반복 지불은 디지털 자산을 사용하여 정기 거래를 자동화하는 방법입니다. 구독 기반 서비스, 기부금, 회원 및 기타 반복 지불에 유용 할 수 있습니다.

반복 결제를 사용하려면 지불 금액, 통화 및 빈도를 지정하는 지불금을 생성 한 다음 지불 인과 공유해야합니다. 지불 인은 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에 대한 반복 지불을 만들려면 :
amount : 20
currency : USD
to_currency : btcAPI는 현재 환율에 따라 20 USD 금액을 BTC의 동등한 것으로 변환하며 사용자는 BTC로 지불합니다. to_currency 는 항상 화폐 통화 코드가 아닌 cryptocurrency 코드 여야합니다.
order_idstringmin:1max:100null시스템에서 ID를 주문하십시오
url_callbackurlnull결제 상태가있는 webhooks가 전송 될 URL
discount_daysintegermin:1max:3650할인 기간 ( '할인 _amount'필요)
discount_amountstringnull할인 금액 ( '할인 _days'와 함께 필요). 여기서 매개 변수 '통화'의 통화 금액
additional_datastringnull추가 반복 지불 세부 정보

매개 변수 유형

string

정의

반복 지불 금액

매개 변수 유형

string

정의

통화 코드

매개 변수 유형

stringmin:3max:60

정의

반복 지불 이름

매개 변수 유형

string

정의

반복되는 지불 기간사용 가능:weeklymonthlythree_month

정의

지불 수락을위한 통화 코드이 매개 변수는 반복 지불 금액을 변환하기위한 대상 통화를 지정하는 데 사용됩니다.예를 들어, 비트 코인에서 20 USD에 대한 반복 지불을 만들려면 :
amount : 20
currency : USD
to_currency : btcAPI는 현재 환율에 따라 20 USD 금액을 BTC의 동등한 것으로 변환하며 사용자는 BTC로 지불합니다. to_currency 는 항상 화폐 통화 코드가 아닌 cryptocurrency 코드 여야합니다.

매개 변수 유형

stringmin:1max:100

정의

시스템에서 ID를 주문하십시오

매개 변수 유형

url

정의

결제 상태가있는 webhooks가 전송 될 URL

매개 변수 유형

integermin:1max:365

정의

할인 기간 ( '할인 _amount'필요)

매개 변수 유형

string

정의

할인 금액 ( '할인 _days'와 함께 필요). 여기서 매개 변수 '통화'의 통화 금액

매개 변수 유형

string

정의

추가 반복 지불 세부 정보

* - 필수 매개 변수

할인:

첫 번째 기간 ( discount_days 매개 변수)은 다른 금액 (discount_amount 매개 변수)입니다. 예를 들어, 처음 30 일과 월간 기간 동안 discount_amount 를 설정할 수 있다면, 사용자는 저렴한 가격으로 첫 번째 지불을 지불하며, 두 번째 및 후속 지불은 전체 가격입니다.

할인 금액은 매개 변수 '통화'로 지정된 통화로되어야합니다.

요청 예제

아래는이 경우 최소 필수 매개 변수의 샘플 예제이며, Fiat Currency USD로 송장이 생성됩니다. 결제 페이지에서 사용자는이 청구서를 지불하기 위해 cryptocurrency 및 네트워크를 선택할 수 있습니다.


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"
}'
복사

응답

응답 매개 변수

이름정의
uuid반복되는 uuid
name반복적 인 이름
order_id시스템에서 ID를 주문하십시오
amount반복 금액
currency통화 코드
payer_currency고객이 지불 해야하는 통화.
payer_amount_usd고객이 지불 해야하는 payer_currency의 동등한 USD 금액
payer_amount고객이 지불 해야하는 payer_currency 의 금액
url_callback결제 상태가있는 webhooks가 전송 될 URL
period반복되는 지불 기간
status반복 상태사용 가능한 옵션 :• wait_accept• cancel_by_merchant• active• cancel_by_user
url지불 인이 지불을 할 Cryptomus 결제 페이지의 URL
last_pay_off마지막 지불 날짜. 시간대는 UTC+3입니다. 값이 NULL 인 경우 지불이 이루어지지 않았습니다.
additional_data추가 반복 지불 세부 정보

정의

반복되는 uuid

정의

반복적 인 이름

정의

시스템에서 ID를 주문하십시오

정의

반복 금액

정의

통화 코드

정의

고객이 지불 해야하는 통화.

정의

고객이 지불 해야하는 payer_currency의 동등한 USD 금액

정의

고객이 지불 해야하는 payer_currency 의 금액

정의

결제 상태가있는 webhooks가 전송 될 URL

정의

반복되는 지불 기간

정의

반복 상태사용 가능한 옵션 :- wait_accept- cancel_by_merchant- active- cancel_by_user

정의

지불 인이 지불을 할 Cryptomus 결제 페이지의 URL

정의

마지막 지불 날짜. 시간대는 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}
복사