curl --request POST \
--url https://api.revolv3.com/api/Subscriptions \
--header 'Content-Type: application/json-patch+json' \
--data '{
"paymentMethods": [
{
"paymentMethodTypes": [
1
],
"priority": 0,
"taxAmount": 2.56,
"originalNetworkTransactionId": "102656693ac3ca6e0cdafbfe89ab99",
"billingAddress": {
"addressId": null,
"addressLine1": "100 Main Street",
"addressLine2": null,
"city": "Irvine",
"state": "CA",
"postalCode": "92602",
"phoneNumber": null,
"email": null,
"country": "US"
},
"creditCard": {
"paymentAccountNumber": "4111111111111111",
"expirationDate": "1025",
"securityCode": null,
"networkToken": null,
"processingMethodType": 5
},
"ach": null,
"googlePay": null,
"applePay": null,
"merchantPaymentMethodRefId": "payment-method-ref-id_hgays-213-44d",
"billingFirstName": "John",
"billingLastName": "Doe",
"billingFullName": null
},
{
"paymentMethodTypes": [
1
],
"priority": 1,
"taxAmount": 1.34,
"originalNetworkTransactionId": null,
"billingAddress": {
"addressId": null,
"addressLine1": "100 Main Street 2",
"addressLine2": null,
"city": "Irvine ",
"state": "CA",
"postalCode": "9260e",
"phoneNumber": null,
"email": null,
"country": "US"
},
"creditCard": {
"paymentAccountNumber": "5555555555554444",
"expirationDate": "03/2030",
"securityCode": null,
"networkToken": null,
"processingMethodType": 5
},
"ach": null,
"googlePay": null,
"applePay": null,
"merchantPaymentMethodRefId": "payment-method-ref-id_hgays-213-4rf4344",
"billingFirstName": "John",
"billingLastName": "Doe",
"billingFullName": null
}
],
"existingPaymentMethod": null,
"merchantSubscriptionRefId": "1234-5678-9101",
"billingFrequency": {
"intervalType": 1,
"intervalCount": 1
},
"subscriptionStatusType": "current",
"subscriptionCancelType": "immediate",
"startDate": "2025-09-08T00:00:00Z",
"trialDuration": 0,
"trialDurationType": 1,
"taxAddress": {
"addressId": null,
"addressLine1": "101 Update Street",
"addressLine2": null,
"city": "Irvine",
"state": "CA",
"postalCode": "92602",
"phoneNumber": null,
"email": null,
"country": "US"
},
"includeRawProcessorResponse": false,
"customer": {
"id": 1,
"firstName": null,
"lastName": null
},
"subscriptionBillingPlans": [
{
"name": "Billing Plan 1",
"value": 10.99,
"cycleCount": -1,
"valueType": "Standard",
"startCycleDelay": 0
},
{
"name": "Billing Plan 2",
"value": 14.99,
"cycleCount": 12,
"valueType": "Standard",
"startCycleDelay": 1
}
],
"recycleImmediatePayment": false,
"currency": 1
}'
{
"subscriptionId": 1,
"customerId": 1,
"merchantSubscriptionRefId": "1234-5678-9101",
"networkTransactionId": null,
"billingIntervalType": "Months",
"billingIntervalCount": 1,
"subscriptionStatusType": "Current",
"subscriptionCancelType": "Immediate",
"initialBillDate": "08-Sep-25",
"nextBillDate": "08-Oct-25",
"taxAddress": null,
"paymentMethodIds": [
1,
2
],
"cancelledAt": null,
"billingPlans": [
{
"subscriptionBillingPlanId": 1,
"subscriptionId": 0,
"name": "Billing Plan 1",
"value": 10.99,
"startDate": "08-Sep-25",
"cyclesRemaining": -1,
"cycleCount": 0,
"valueType": "Standard"
},
{
"subscriptionBillingPlanId": 2,
"subscriptionId": 0,
"name": "Billing Plan 2",
"value": 14.99,
"startDate": "08-Oct-25",
"cyclesRemaining": 12,
"cycleCount": 0,
"valueType": "Standard"
}
],
"message": null,
"paymentProcessor": null,
"processorMerchantId": null,
"processorRawResponse": null,
"currency": null
}
Create a subscription for a customer with a Billing Frequency Type (Daily, Weekly, Biweekly, Monthly, Bimonthly, Quarterly, Semiannually, Yearly), subscription Billing Plans items, the payment method objects list with priorities and tax amount (each object with billing address, billing first name, billing last name, payment method type (credit card, ach, google pay)) or existing payment method object with tax amount (with an authorized payment method id or payment method id) must be provided.
Optionally, a Merchant Subscription Ref ID, Tax Address, Start Date, Trial Duration, Trial Duration Type (the same values as in Billing Frequency Type), Subscription Status Type (Current, Recycle) and Subscription Cancel Type (Immediate, EndOfCycle) may be included.
Upon successful creation of the subscription, a status code of 201 (Created) will be returned.
If the provided Customer ID does not exist, a status code of 404 (Not Found) will be returned.
If a subscription cannot be created with the provided data, a status code of 400 (Bad Request) will be returned.
curl --request POST \
--url https://api.revolv3.com/api/Subscriptions \
--header 'Content-Type: application/json-patch+json' \
--data '{
"paymentMethods": [
{
"paymentMethodTypes": [
1
],
"priority": 0,
"taxAmount": 2.56,
"originalNetworkTransactionId": "102656693ac3ca6e0cdafbfe89ab99",
"billingAddress": {
"addressId": null,
"addressLine1": "100 Main Street",
"addressLine2": null,
"city": "Irvine",
"state": "CA",
"postalCode": "92602",
"phoneNumber": null,
"email": null,
"country": "US"
},
"creditCard": {
"paymentAccountNumber": "4111111111111111",
"expirationDate": "1025",
"securityCode": null,
"networkToken": null,
"processingMethodType": 5
},
"ach": null,
"googlePay": null,
"applePay": null,
"merchantPaymentMethodRefId": "payment-method-ref-id_hgays-213-44d",
"billingFirstName": "John",
"billingLastName": "Doe",
"billingFullName": null
},
{
"paymentMethodTypes": [
1
],
"priority": 1,
"taxAmount": 1.34,
"originalNetworkTransactionId": null,
"billingAddress": {
"addressId": null,
"addressLine1": "100 Main Street 2",
"addressLine2": null,
"city": "Irvine ",
"state": "CA",
"postalCode": "9260e",
"phoneNumber": null,
"email": null,
"country": "US"
},
"creditCard": {
"paymentAccountNumber": "5555555555554444",
"expirationDate": "03/2030",
"securityCode": null,
"networkToken": null,
"processingMethodType": 5
},
"ach": null,
"googlePay": null,
"applePay": null,
"merchantPaymentMethodRefId": "payment-method-ref-id_hgays-213-4rf4344",
"billingFirstName": "John",
"billingLastName": "Doe",
"billingFullName": null
}
],
"existingPaymentMethod": null,
"merchantSubscriptionRefId": "1234-5678-9101",
"billingFrequency": {
"intervalType": 1,
"intervalCount": 1
},
"subscriptionStatusType": "current",
"subscriptionCancelType": "immediate",
"startDate": "2025-09-08T00:00:00Z",
"trialDuration": 0,
"trialDurationType": 1,
"taxAddress": {
"addressId": null,
"addressLine1": "101 Update Street",
"addressLine2": null,
"city": "Irvine",
"state": "CA",
"postalCode": "92602",
"phoneNumber": null,
"email": null,
"country": "US"
},
"includeRawProcessorResponse": false,
"customer": {
"id": 1,
"firstName": null,
"lastName": null
},
"subscriptionBillingPlans": [
{
"name": "Billing Plan 1",
"value": 10.99,
"cycleCount": -1,
"valueType": "Standard",
"startCycleDelay": 0
},
{
"name": "Billing Plan 2",
"value": 14.99,
"cycleCount": 12,
"valueType": "Standard",
"startCycleDelay": 1
}
],
"recycleImmediatePayment": false,
"currency": 1
}'
{
"subscriptionId": 1,
"customerId": 1,
"merchantSubscriptionRefId": "1234-5678-9101",
"networkTransactionId": null,
"billingIntervalType": "Months",
"billingIntervalCount": 1,
"subscriptionStatusType": "Current",
"subscriptionCancelType": "Immediate",
"initialBillDate": "08-Sep-25",
"nextBillDate": "08-Oct-25",
"taxAddress": null,
"paymentMethodIds": [
1,
2
],
"cancelledAt": null,
"billingPlans": [
{
"subscriptionBillingPlanId": 1,
"subscriptionId": 0,
"name": "Billing Plan 1",
"value": 10.99,
"startDate": "08-Sep-25",
"cyclesRemaining": -1,
"cycleCount": 0,
"valueType": "Standard"
},
{
"subscriptionBillingPlanId": 2,
"subscriptionId": 0,
"name": "Billing Plan 2",
"value": 14.99,
"startDate": "08-Oct-25",
"cyclesRemaining": 12,
"cycleCount": 0,
"valueType": "Standard"
}
],
"message": null,
"paymentProcessor": null,
"processorMerchantId": null,
"processorRawResponse": null,
"currency": null
}
Created
The response is of type object
.