반복적 인 지불 생성

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_id	stringmin:1max:100alpha_dash	null	시스템에서 ID를 주문하십시오
url_callback	url	null	결제 상태가있는 webhooks가 전송 될 URL
discount_days	integermin:1max:365	0	할인 기간 ( '할인 _amount'필요)
discount_amount	string	null	할인 금액 ( '할인 _days'와 함께 필요). 여기서 매개 변수 '통화'의 통화 금액
additional_data	string	null	추가 반복 지불 세부 정보

: 매개 변수 유형
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:100alpha_dash
기본값
null
정의
시스템에서 ID를 주문하십시오
: 매개 변수 유형
url
기본값
null
정의
결제 상태가있는 webhooks가 전송 될 URL
: 매개 변수 유형
integermin:1max:365
기본값
0
정의
할인 기간 ( '할인 _amount'필요)
: 매개 변수 유형
string
기본값
null
정의
할인 금액 ( '할인 _days'와 함께 필요). 여기서 매개 변수 '통화'의 통화 금액
: 매개 변수 유형
string
기본값
null
정의
추가 반복 지불 세부 정보

* - 필수 매개 변수

할인:

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

: 매개 변수 유형
string
정의
반복되는 uuid
: 매개 변수 유형
string
정의
반복적 인 이름
: 매개 변수 유형
string|null
정의
시스템에서 ID를 주문하십시오
: 매개 변수 유형
string
정의
반복 금액
: 매개 변수 유형
string
정의
통화 코드
: 매개 변수 유형
string|null
정의
고객이 지불 해야하는 통화.
: 매개 변수 유형
string
정의
고객이 지불 해야하는 payer_currency의 동등한 USD 금액
: 매개 변수 유형
string|null
정의
고객이 지불 해야하는 payer_currency 의 금액
: 매개 변수 유형
string|null
정의
결제 상태가있는 webhooks가 전송 될 URL
: 매개 변수 유형
string
정의
반복되는 지불 기간
: 매개 변수 유형
string
정의
반복 상태사용 가능한 옵션 :- wait_accept- cancel_by_merchant- active- cancel_by_user
: 매개 변수 유형
string
정의
지불 인이 지불을 할 Cryptomus 결제 페이지의 URL
: 매개 변수 유형
string|null
정의
마지막 지불 날짜. 시간대는 UTC+3입니다. 값이 NULL 인 경우 지불이 이루어지지 않았습니다.
: 매개 변수 유형
string|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}

복사