RevCent API
The RevCent API is a JSON based API. Current version is v1. All calls are performed via http POST, with a JSON body, and application/json as the content type. This allows a coding language agnostic method of calling the RevCent API without the need for an SDK. Simply call the API endpoint using your authorization credentials in the header.
All api calls must use the http POST method. Other http methods will be rejected. It is important to set the Content-Type in your POST header to "application/json".
Whitelist RevCent: All requests from RevCent will use the following IP addresses:
34.224.171.255
52.3.146.218
54.174.155.188
If you need help please do not hesitate to contact us.
API Endpoint
https://api.revcent.com/v1
Authentication
Each account has two API Keys, a live key and a test key. This allows you to test the API and view results using the test/live mode toggle in the user dashboard.
Depending on the key used, RevCent will use the appropriate merchant gateway endpoint for test/live transactions. For example, if you use a test RevCent key we will use the test endpoint for the merchant gateway. A live RevCent key will use the live merchant gateway endpoint.
The x-api-key should be in the header of the API request.
Example
"headers": { "Content-Type": "application/json", "x-api-key": "YOUR_REVCENT_API_KEY" }
Request Body
Every request body is a JSON object, containing the request object. The request object contains both type and method properties. This determines the actions that the specific POST request is going to perform.
In the example, the type is 'sale' and the method is 'retrieve'. Depending on the type and method, certain properties are required. All schema examples in the docs specify required properties depending on request.
Example
{ "request": { "type": "sale", "method": "retrieve", "id": "mJWJbKNQ4QI8XbwmyyW7" } }
Request Example
The example contains a request using CURL showing the POST method, content-type header, x-api-key header and JSON body.
Example
curl --location --request POST 'https://api.revcent.com/v1' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_REVCENT_API_KEY' \ --data-raw '{ "request": { "type": "sale", "method": "retrieve", "id": "mJWJbKNQ4QI8XbwmyyW7" } }'
Idempotent Requests
The RevCent API supports idempotency for safely retrying API requests without performing the same specific operation twice.
This is useful for retrying disrupted requests while avoiding the chance of double charging a customer. To perform an idempotent request, provide the idempotency_key property within the request object. RevCent will check existing idempotency keys submitted within the past 24 hours for the API account. If an idempotency key match is found, the API request is immediately rejected and not saved.
The idempotency key must be at least 10 characters in length and can be up to 255 characters in length. We recommended you use V4 UUIDs. Retrieve requests ignore idempotency keys.
Important: Only use idempotency keys if you know when and why to use them. Resubmitting the same idempotency key when purposely retrying a declined payment request will result in an error, and the retry payment will never be attempted.
Example
{ "request": { "type": "sale", "method": "create", "idempotency_key": "2c74f520-2b7f-44ea-b547-96e3fcaf7462", ... } }
Campaign
A campaign is a way to group, categorize and filter various items within your account.
Campaign Create
Create a new campaign.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The campaign name.
The campaign description.
The campaign status.
An array of one or more organization IDs.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The RevCent ID of the campaign.
The name of the campaign associated with the item.
The API request method.
The API request type.
The a brief description of the result of the API call.
Request JSON
{ "request": { "type": "campaign", "method": "create", "name": "New Name", "description": "Description.", "enabled": false, "organization": [ "4rBAwPJzlPSg9lRwGVmX", "NkEzVWEdV7C9wvKn19Q8" ] } }
Response JSON
{ "api_call_date": "2023-02-02T19:51:40+00:00", "api_call_id": "KnBKryj7jOFPLW1pqkVM", "api_call_processed": true, "api_call_unix": 1675367500, "campaign_id": "rmNPb2opoyfdBV4v0m7P", "campaign_name": "New Name", "code": 1, "organization": [ { "id": "4rBAwPJzlPSg9lRwGVmX", "name": "AdWords Org" }, { "id": "NkEzVWEdV7C9wvKn19Q8", "name": "Acme Org" } ], "request_method": "create", "request_type": "campaign", "result": "Campaign created." }
Campaign Edit
Modify a campaign. Only provide the fields you wish to modify.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The campaign ID.
The campaign name.
The campaign description.
The campaign status.
An array of one or more organization IDs.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The RevCent ID of the campaign.
The name of the campaign associated with the item.
The API request method.
The API request type.
The a brief description of the result of the API call.
Request JSON
{ "request": { "type": "campaign", "method": "edit", "name": "Updated Name", "description": "Description.", "enabled": true, "campaign_id": "rmNPb2opoyfdBV4v0m7P", "organization": [ "NkEzVWEdV7C9wvKn19Q8" ] } }
Response JSON
{ "api_call_date": "2023-02-02T19:51:04+00:00", "api_call_id": "9rwkYO1v7XFEB6mGdM8p", "api_call_processed": true, "api_call_unix": 1675367464, "campaign_id": "rmNPb2opoyfdBV4v0m7P", "code": 1, "organization": [ { "id": "NkEzVWEdV7C9wvKn19Q8", "name": "Acme Org" } ], "request_method": "edit", "request_type": "campaign", "result": "Campaign edited." }
Campaign Retrieve
Retrieve current information on a single campaign or multiple campaigns.
Please view Pagination and Filters for details on retrieving multiple items.
Request JSON Schema
The main request object.
The type of request being made.
The method for the request type.
The RevCent ID of the item. Required if multiple property equals false or is not present.
Whether it is a multiple type request.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The number of result items contained in the current page.
The current page of result, same as requested page, default is page 1.
The API request method.
The API request type.
An array of objects, each object being a unique item.
The unix timestamp of when the item was created.
The description of the item.
Whether the campaign is enabled.
The RevCent ID of the object item.
The name of the item.
Any organizations associated with the campaign.
Organization ID.
Organization name.
The unix timestamp of when the item was updated.
The total number of result items for the given request.
The total number of pages for the given request.
Request JSON
{ "request": { "type": "campaign", "method": "retrieve", "id": "JN0Zpj7RGJiwKqAnRoy6" } }
Response JSON
{ "api_call_id": "Q45jJa6ZjgFYmK5Ek86l", "api_call_processed": true, "api_call_unix": 1570281688, "code": 1, "current_count": 1, "current_page": 1, "request_method": "retrieve", "request_type": "campaign", "results": [ { "created_date_unix": 1550530876, "description": "Twitter campaign sales and customers.", "enabled": true, "id": "JN0Zpj7RGJiwKqAnRoy6", "name": "Twitter Campaign", "organization": [ { "id": "NkEzVWEdV7C9wvKn19Q8", "name": "Acme Org" } ], "updated_date_unix": 1551406538 } ], "total_count": 1, "total_pages": 1 }
Chargeback
A chargeback within RevCent is created either using the API or via a third party integration for credit card transactions within RevCent.
Chargeback Create
Create a chargeback within RevCent via the chargeback create method. A chargeback is specific to an existing RevCent credit card transaction. Therefore, when creating a chargeback, the transaction_id or gateway_transaction_id for the related transaction must be provided.
It is recommended to distinguish the chargebacks by sub type(s), i.e. Verifi, RDR, etc., if applicable, using metadata. Only include metadata entries that are applicable to the chargeback. Examples recognized by RevCent below:
- RDR
- { "name": "is_rdr", "value": "true" }
- Verifi
- { "name": "is_verifi", "value": "true" }
- Ethoca
- { "name": "is_ethoca", "value": "true" }
- TC40
- { "name": "is_tc40", "value": "true" }
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The RevCent transaction ID for the chargeback related transaction. If not present, you must provide the gateway_transaction_id property.
The gateway transaction ID for the chargeback related transaction. Only provide if the transaction_id property is not present.
The chargeback amount.
The acquirer reference number.
The date the chargeback created by the issuing bank.
The date the chargeback was received.
The chargeback case number.
The chargeback reason code.
The RevCent third party integration ID.
The third party chargeback ID.
The third party order ID.
You can choose to void the transaction, which will automatically issue a full refund. Default is false. Note: This cannot be undone.
Representment details related to the chargeback, if a representment has taken place.
Whether a representment has been initiated. Read-only once set.
The date the representment was initiated. Read-only once set.
Whether the representment has completed, with an outcome. The initiated property must be set, or have been previously set, to true. Read-only once set.
The date the representment was completed, with an outcome. Read-only once set.
The outcome of the chargeback representment. Can be either "pending", "won" or "lost". The initiated and completed properties must be set, or have been previously set, to true.
Response JSON Schema
The amount of the item.
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The RevCent ID of the campaign.
The name of the campaign associated with the item.
The RevCent ID of the chargeback.
The result code for the request.
0 = RevCent Error
1 = Success
The RevCent ID of the customer.
Gateway related to the item.
The RevCent ID of the gateway.
The transaction ID assigned by the merchant gateway.
The merchant account ID associated with the merchant gateway.
The API request method.
The API request type.
The a brief description of the result of the API call.
The RevCent ID of the credit card transaction.
Whether the transaction was simultaneously voided along with the chargeback creation.
Request JSON
{ "request": { "type": "chargeback", "method": "create", "transaction_id": "EMO5Xo8qMEf15YXQywkR", "gateway_transaction_id": "60157523306", "amount": 140, "arn": "arn_1", "chargeback_date": "12/01/2020", "received_date": "12/04/2020", "case_number": "1234", "reason_code": "4", "third_party_chargeback_id": "cb_1", "third_party_order_id": "or_1", "void_transaction": false, "representment": { "initiated": true, "initiated_date": "12/04/2020" }, "metadata": [ { "name": "is_verifi", "value": "true" } ] } }
Response JSON
{ "amount": 21.39, "api_call_id": "WmbX7n17zGTL65ZqPnp9", "api_call_processed": true, "api_call_unix": 1609122150, "campaign_id": "mJ1zZoOobEuP8pnWKXd1", "campaign_name": "Adwords Campaign", "chargeback_id": "j0a9dNwVKqu8Qz5Vl6ZZ", "code": 1, "customer_id": "2rn1nnqKN6i6wmdKolJE", "gateway": "Authorize.net", "gateway_id": "LYE26MW8Rlh5VbJmlp2l", "gateway_transaction_id": "60158956353", "merchant_account_id": "5678", "request_method": "create", "request_type": "chargeback", "result": "Chargeback created.", "transaction_id": "gYZVZZbdmRTl7g2aJyNN", "void_transaction": false }
Chargeback Edit
Edit an existing chargeback within RevCent via the chargeback edit method.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The RevCent chargeback ID.
The chargeback amount.
The acquirer reference number.
The date the chargeback created by the issuing bank.
The date the chargeback was received.
The chargeback case number.
The chargeback reason code.
The RevCent third party integration ID.
The third party chargeback ID.
The third party order ID.
Representment details related to the chargeback, if a representment has taken place.
Whether a representment has been initiated. Read-only once set.
The date the representment was initiated. Read-only once set.
Whether the representment has completed, with an outcome. The initiated property must be set, or have been previously set, to true. Read-only once set.
The date the representment was completed, with an outcome. Read-only once set.
The outcome of the chargeback representment. Can be either "pending", "won" or "lost". The initiated and completed properties must be set, or have been previously set, to true.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The RevCent ID of the chargeback.
The result code for the request.
0 = RevCent Error
1 = Success
The API request method.
The API request type.
The a brief description of the result of the API call.
Request JSON
{ "request": { "type": "chargeback", "method": "edit", "chargeback_id": "0p9yLjoq91u9wVEqZ2M2", "amount": 140, "arn": "arn_1", "chargeback_date": "10/01/2020", "received_date": "10/04/2020", "case_number": "1234", "reason_code": "4", "third_party_chargeback_id": "cb_1", "third_party_order_id": "or_1", "representment": { "completed": true, "completed_date": "12/04/2020", "outcome": "won" }, "metadata": [ { "name": "is_rdr", "value": "true" } ] } }
Response JSON
{ "api_call_id": "mJLY1aqWOvCJBL4wAqV8", "api_call_processed": true, "api_call_unix": 1609122072, "chargeback_id": "Nk6llENAROsKvm8PLlOw", "code": 1, "request_method": "edit", "request_type": "chargeback", "result": "Chargeback edited." }
Chargeback Retrieve
Retrieve current information on a single chargeback or multiple chargebacks.
Please view Pagination and Filters for details on retrieving multiple items.
Request JSON Schema
The main request object.
The type of request being made.
The method for the request type.
The RevCent ID of the item. Required if multiple property equals false or is not present.
Whether it is a multiple type request.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The number of result items contained in the current page.
The current page of result, same as requested page, default is page 1.
The API request method.
The API request type.
An array of objects, each object being a unique item.
The amount of the transaction associated with the fraud detection.
The acquirer reference number, if applicable.
The RevCent ID of the campaign.
The name of the campaign associated with the item.
The case number, if applicable.
The date the chargeback occurred.
The unix timestamp of the date the chargeback occurred.
An array containing check direct IDs related to the item.
The unix timestamp of when the item was created.
The customer object.
The customers' first address line.
The customers' second address line.
Whether the customer has been blocked from purchases.
The customers' city.
The customers' company.
The customers' country.
The customers' email.
Whether the customer is currently enabled.
The customers' first name.
The customers' full address.
Whether the customers' address was successfully geocoded using the Google geocoding service.
The Google place ID for the customers' address using the Google geocoding service.
The RevCent ID for the customer.
Your internal ID for the customer.
The customers' last name.
The approximate latitude for the customers' address using the Google geocoding service.
The approximate longitude for the customers' address using the Google geocoding service.
The customers' phone number.
The customers' state.
The customers' state in long format.
The customers' status.
The customers' zip or postal code.
An array containing discounts related to the item.
An array containing fraud detection IDs related to the item.
Gateway related to the item.
The name of the item.
The RevCent ID of the object item.
The merchant account ID associated with the merchant gateway.
The transaction ID assigned by the merchant gateway.
The RevCent ID of the object item.
An array containing invoice IDs related to the item.
Whether the chargeback is associated with a RevCent third party integration.
ISO 4217 currency code.
Whether the item was created using a live or test RevCent API key.
The merchant account ID associated with the merchant gateway.
An array containing offline payment IDs related to the item.
The original API call that created the entity associated with the chargeback.
The RevCent ID of the original API call that created the entity associated with the chargeback.
The date of the API call.
The unix timestamp of the date of the API call.
The API call type.
The API call method.
The IP address that was used to make the API call.
An array containing RevCent PayPal transaction IDs related to the item.
An array containing pending refund IDs related to the item.
An array containing product sale IDs related to the item.
The chargeback reason code.
The date the chargeback was received by you or the third party.
The unix timestamp of the date the chargeback was received by you or the third party.
If a chargeback has an initiated representment, details on the representment will be provided.
Whether a representment has been initiated.
The date the representment was initiated.
Whether the representment has completed.
The date the representment was completed, with an outcome.
The outcome of the chargeback representment. Can be either "pending", "won" or "lost".
An array containing sale IDs related to the item.
An array containing salvage transaction IDs related to the item.
An array containing shipping IDs related to the item.
The current status of the related item.
An array containing subscription renewal IDs related to the item.
An array containing tax IDs related to the item.
The third party chargeback ID.
If the chargeback was created by a third party integration, details will appear here.
The ID of your RevCent third party integration.
The name of your RevCent third party integration.
Details on the specific third party.
The RevCent ID for the third party.
The name of the third party.
The third party order ID.
The specific transaction the chargeback is related to.
The RevCent transaction ID.
The unix timestamp of the date the transaction was created.
The date the transaction was created.
The unix timestamp of the date the transaction was updated.
The date the transaction was updated.
The transaction amount.
An array containing credit card transaction IDs related to the item.
An array containing trial IDs related to the item.
The unix timestamp of when the item was updated.
An array containing usage account invoice IDs related to the item.
An array containing usage account IDs related to the item.
An array containing usage item invoice IDs related to the item.
An array containing usage item IDs related to the item.
The total number of result items for the given request.
The total number of pages for the given request.
Request JSON
{ "request": { "type": "chargeback", "method": "retrieve", "id": "O04ll4qkllTXqA5Xd79L" } }
Response JSON
{ "api_call_id": "5rkZvym5BNIO6WQX9PJl", "api_call_processed": true, "api_call_unix": 1609120332, "code": 1, "current_count": 1, "current_page": 1, "request_method": "retrieve", "request_type": "chargeback", "results": [ { "amount": 42.36, "arn": "12345", "campaign_id": "JN0Zpj7RGJiwKqAnRoy6", "campaign_name": "Twitter Campaign", "case_number": "56789", "chargeback_date": "2020-12-23T05:00:00+00:00", "chargeback_date_unix": 1608699600, "check_directs": [], "created_date_unix": 1608738415, "customer": { "address_line_1": "1600 Pennsylvania Ave", "address_line_2": "", "blocked": false, "city": "Washington", "company": "", "country": "USA", "email": "georgew@whitehouse.com", "enabled": true, "first_name": "George", "full_address": "1600 Pennsylvania Ave NW, Washington, DC 20500, USA", "geocode_success": true, "google_place_id": "ChIJGVtI4by3t4kRr51d_Qm_x58", "id": "4r158EzJmmcVM69dNLkg", "internal_id": "pres_0001", "last_name": "Washington", "lat": "38.8976633", "lon": "-77.0365739", "metadata": [], "phone": "1234567890", "state": "DC", "state_long": "DC", "zip": "20500" }, "discounts": [], "fraud_detections": [], "gateway": { "name": "Authorize.net", "id": "LYE26MW8Rlh5VbJmlp2l", "merchant_account_id": "12345678" }, "gateway_transaction_id": "60158776104", "id": "O04ll4qkllTXqA5Xd79L", "invoices": [], "is_third_party_integration": false, "iso_currency": "USD", "live_mode": false, "merchant_account_id": "12345678", "metadata": [], "offline_payments": [], "origin_api_call": { "id": "RJblXjvvEgsqjGQrBjoX", "date": "2020-12-22T23:22:04+00:00", "date_unix": 1608679324, "type": "subscription", "method": "renew", "ip_address": "123.456.789.101" }, "paypal_transactions": [], "pending_refunds": [], "product_sales": [], "reason_code": "2", "received_date": "2020-12-23T05:00:00+00:00", "received_date_unix": 1608699600, "representment": { "initiated": true, "initiated_date": "2020-12-22T23:22:05+00:00", "completed": true, "completed_date": "2020-12-25T01:26:18+00:00", "outcome": "won" }, "sales": [ "y2wARbKL8PCPL46Xb7qA" ], "salvage_transactions": [], "shipping": [ "y2Wrl6kwZoUdBWJjABp0" ], "status": "Created", "subscription_renewals": [ "zGkXy5Qa0OH4qWAozq58" ], "tax": [ "qZM1QVAqwRik6BJNq6vW" ], "third_party_chargeback_id": "", "third_party_integration": null, "third_party_order_id": "", "transaction": { "id": "pgPbQlGpr8fWQ72NbQrB", "created_date_unix": 1608679325, "created_date": "2020-12-22T23:22:05+00:00", "updated_date_unix": 1608859578, "updated_date": "2020-12-25T01:26:18+00:00", "amount": 42.36 }, "transactions": [ "pgPbQlGpr8fWQ72NbQrB" ], "trials": [], "updated_date_unix": 1608738415, "usage_account_invoices": [], "usage_accounts": [], "usage_item_invoices": [], "usage_items": [] } ], "total_count": 1, "total_pages": 1 }
Coupon
A coupon is created within the RevCent web app and can be applied to initial sales, subsequent subscription renewals and future customer purchases based on settings. Create specific rules, expiration dates and discount types within the web app when creating a coupon.
Coupon Validate
Validate a coupon using the coupon code. A rejected coupon code will display an error explaining the reason for rejection, while an applicable coupon code will display the discount type and amount.
To get the actual discount amount for a new sale using a valid coupon, use the sale estimate API request.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The coupon code.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The coupon associated with the coupon code.
If coupon code submitted is invalid, this coupon property will equal null.
Check for null coupon property in response to validate coupon code.
The RevCent ID of the object item.
The coupon code.
Whether the coupon is enabled.
The coupon start date.
The coupon end date.
The coupon discount type, either percent or amount.
The coupon discount value relative to the discount type.
The total number of times the coupon was used in a successful sale.
The coupon profile associated with the coupon.
The RevCent ID of the object item.
Whether the coupon profile is enabled.
Whether there is a maximum use limit within the coupon profile associated with the coupon.
The API request method.
The API request type.
Whether the coupon code is valid. If invalid (coupon = null) the reason for the coupon code being invalid.
Request JSON
{ "request": { "type": "coupon", "method": "validate", "coupon_code": "10percent" } }
Response JSON
{ "api_call_id": "qZBoPgKB0lIOJG6LJZ4R", "api_call_processed": true, "api_call_unix": 1570459361, "code": 1, "coupon": { "id": "VPmmrpbVl7cQ9JaXEanl", "coupon_code": "10percent", "enabled": true, "start_date_unix": 1567559820, "end_date_unix": 1580446800, "discount_type": "percent", "discount_value": 10, "num_use": 66, "coupon_profile": { "id": "k6vvXQwwNycvJM7yMwzL", "enabled": true, "num_use_max": 0 } }, "request_method": "validate", "request_type": "coupon", "result": "Valid" }
Customer
A customer is an individual that is created either by sale, signup, etc. Every customer is given a unique ID as well as the ability to add multiple credit cards.
Implement metadata when creating a sale or customer for enhanced analytics. Our TrackJS feature is extremely useful for tracking visitors and linking them to new customers. We highly recommend you implement metadata as well as TrackJS to know more about your customers.
Customer Create
Create a customer via the customer create method. Useful for signup or prospect purposes where a sale has yet to take place.
AdWords Integration
If you wish to associate the item with a specific AdWords click ID include an "adwords_click" object in your request metadata array. RevCent will detect the specific metadata object with name="adwords_click" and pull data on the AdWords click ID. Read more about integrating AdWords with RevCent on our Knowledge Base .
Example
"metadata":[{"name": "adwords_click", "value": "ADWORDS_CLICK_ID_HERE"}]
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The customer object receives first priority as details if creating a new customer.
If the customer object is not present the bill_to and ship_to objects will be used in the respective order.
If neither customer, bill_to or ship_to objects are provided the new customer will be created as 'Anonymous'.
This does not apply if using a customer_id field in the request where applicable.
To use as the billing information. If not present the customer object will be used.
Your internal customer ID.
The campaign to associate with the request. This can be either the RevCent ID of the campaign or the RevCent name of the campaign.
If you wish to add a payment method with the customer upon creation.
The credit card number. This value must be a valid credit card number as a string.
The credit card expiration month. Two digit integer, MM.
The credit card expiration year. Two digit integer, YY.
The credit card code as a string. Depending on the card type this can be different lengths.
If you wish to set the credit card as the default payment method for the customer. Default is true if customer has no active or unexpired cards on file.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The RevCent ID of the campaign.
The name of the campaign associated with the item.
The RevCent ID of the customer credit card used if a transaction occurred.
The result code for the request.
0 = RevCent Error
1 = Success
The email address of the related customer.
The first name of the related customer.
The RevCent ID of the customer.
The last name of the related customer.
The API request method.
The API request type.
The a brief description of the result of the API call.
Request JSON
{ "request": { "type": "customer", "method": "create", "campaign": "Twitter Campaign", "customer": { "first_name": "udhi", "last_name": "pguolnvc", "address_line_1": "1600 Pennsylvania Ave", "address_line_2": "", "city": "Washington", "state": "DC", "zip": "20500", "country": "USA", "company": "", "email": "ndjo@gmail.com", "phone": "1234567890" }, "bill_to": { "first_name": "udhi", "last_name": "pguolnvc", "address_line_1": "1600 Pennsylvania Ave", "address_line_2": "", "city": "Washington", "state": "DC", "zip": "20500", "country": "USA", "company": "", "email": "ndjo@gmail.com", "phone": "1234567890" }, "internal_customer_id": "cus_7791", "payment": { "credit_card": { "card_number": "4242424242424242", "exp_month": 12, "exp_year": 20, "card_code": "999" } }, "metadata": [ { "name": "adwords_click", "value": "Cjat0KwhCQjdTq..." }, { "name": "sign_up_page", "value": "v1" } ] } }
Response JSON
{ "api_call_id": "Nk5voyYVvgTOJkEdGRyj", "api_call_processed": true, "api_call_unix": 1565814918, "campaign_id": "JN0Zpj7RGJiwKqAnRoy6", "campaign_name": "Twitter Campaign", "card_id": "YaVqjAZNqzCGvrrZgGqm", "code": 1, "customer_email": "ndjo@gmail.com", "customer_first_name": "udhi", "customer_id": "mJGAbQ0zAmU12rpngR1M", "customer_last_name": "pguolnvc", "request_method": "create", "request_type": "customer", "result": "Created new customer and added card." }
Customer Edit
Edit customer information.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The customer ID
The customer object receives first priority as details if creating a new customer.
If the customer object is not present the bill_to and ship_to objects will be used in the respective order.
If neither customer, bill_to or ship_to objects are provided the new customer will be created as 'Anonymous'.
This does not apply if using a customer_id field in the request where applicable.
Your internal customer ID.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The RevCent ID of the customer.
The API request method.
The API request type.
The a brief description of the result of the API call.
Request JSON
{ "request": { "type": "customer", "method": "edit", "customer_id": "mJGAbQ0zAmU12rpngR1M", "customer": { "first_name": "ywbw", "last_name": "fbjdbefa", "address_line_1": "1600 Pennsylvania Ave", "address_line_2": "", "city": "Washington", "state": "DC", "zip": "20500", "country": "USA", "company": "", "email": "izlo@gmail.com", "phone": "1234567890" } } }
Response JSON
{ "api_call_id": "P65Gn2z6WMs552lNYg6q", "api_call_processed": true, "api_call_unix": 1565814919, "code": 1, "customer_id": "mJGAbQ0zAmU12rpngR1M", "request_method": "edit", "request_type": "customer", "result": "Customer information successfully edited." }
Customer Enable
Enabled a customer that was previously disabled.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The customer ID
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The RevCent ID of the customer.
The API request method.
The API request type.
The a brief description of the result of the API call.
Request JSON
{ "request": { "type": "customer", "method": "enable", "customer_id": "mJGAbQ0zAmU12rpngR1M" } }
Response JSON
{ "api_call_id": "BvwOyAQgd8u226OMrOqY", "api_call_processed": true, "api_call_unix": 1565814920, "code": 1, "customer_id": "mJGAbQ0zAmU12rpngR1M", "request_method": "enable", "request_type": "customer", "result": "Customer enabled." }
Customer Disable
Disable a customer, preventing future purchases.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The customer ID
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The RevCent ID of the customer.
The API request method.
The API request type.
The a brief description of the result of the API call.
Request JSON
{ "request": { "type": "customer", "method": "disable", "customer_id": "mJGAbQ0zAmU12rpngR1M" } }
Response JSON
{ "api_call_id": "ZVEGoyPVA0fZJMPo8Kav", "api_call_processed": true, "api_call_unix": 1565814919, "code": 1, "customer_id": "mJGAbQ0zAmU12rpngR1M", "request_method": "disable", "request_type": "customer", "result": "Customer disabled." }
Customer Add Card
Add a credit card to a customer, with the ability to set the card as default.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The customer ID
To use as the billing information. If not present the customer object will be used.
The payment object containing the credit card you wish to add.
The credit card number. This value must be a valid credit card number as a string.
The credit card expiration month. Two digit integer, MM.
The credit card expiration year. Two digit integer, YY.
The credit card code as a string. Depending on the card type this can be different lengths.
If you wish to set the credit card as the default payment method for the customer. Default is true if customer has no active or unexpired cards on file.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The RevCent ID of the customer.
The API request method.
The API request type.
The a brief description of the result of the API call.
Request JSON
{ "request": { "type": "customer", "method": "add_card", "customer_id": "mJGAbQ0zAmU12rpngR1M", "bill_to": { "first_name": "orhw", "last_name": "selldjxk", "address_line_1": "1600 Pennsylvania Ave", "address_line_2": "", "city": "Washington", "state": "DC", "zip": "20500", "country": "USA", "company": "", "email": "utnl@gmail.com", "phone": "1234567890" }, "payment": { "credit_card": { "card_number": "4141414141414141", "exp_month": 10, "exp_year": 23, "card_code": "123", "set_as_default": true } } } }
Response JSON
{ "api_call_id": "j0LNQJG1B7UggmXw950J", "api_call_processed": true, "api_call_unix": 1565814920, "code": 1, "customer_id": "mJGAbQ0zAmU12rpngR1M", "request_method": "add_card", "request_type": "customer", "result": "Customer card added." }
Customer Add To Group
Add a customer to a customer group.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The customer ID
An array of one or more Customer Group IDs.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The RevCent ID of the customer.
The API request method.
The API request type.
The a brief description of the result of the API call.
Request JSON
{ "request": { "type": "customer", "method": "add_to_group", "customer_id": "LY9BAEgLymHObBR7GKdw", "customer_group": [ "8rRGOVwwNLTaawApmQv8" ] } }
Response JSON
{ "api_call_id": "ZVEGoyPVA0fZJMPo8Kav", "api_call_processed": true, "api_call_unix": 1565814919, "code": 1, "customer_id": "mJGAbQ0zAmU12rpngR1M", "request_method": "add_to_group", "request_type": "customer", "result": "Customer added to group(s)." }
Customer Remove From Group
Remove a customer from a customer group.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The customer ID
An array of one or more Customer Group IDs.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The RevCent ID of the customer.
The API request method.
The API request type.
The a brief description of the result of the API call.
Request JSON
{ "request": { "type": "customer", "method": "remove_from_group", "customer_id": "LY9BAEgLymHObBR7GKdw", "customer_group": [ "8rRGOVwwNLTaawApmQv8" ] } }
Response JSON
{ "api_call_id": "ZVEGoyPVA0fZJMPo8Kav", "api_call_processed": true, "api_call_unix": 1565814919, "code": 1, "customer_id": "mJGAbQ0zAmU12rpngR1M", "request_method": "remove_from_group", "request_type": "customer", "result": "Customer removed from group(s)." }
Customer Retrieve
Retrieve current information on a single customer or multiple customers. You can use either the RevCent ID or email address for retrieving a single customer.
Please view Pagination and Filters for details on retrieving multiple items.
The response may include AdWords Response Objects within each item if an AdWords click ID is associated with the item.
Request JSON Schema
The main request object.
The request type.
The request method.
The RevCent ID of the customer. Required if multiple property equals false and email property not present.
The email address of the customer. Required if multiple property equals false and id property not present.
Whether it is a multiple type request.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The number of result items contained in the current page.
The current page of result, same as requested page, default is page 1.
The API request method.
The API request type.
An array of objects, each object being a unique item.
Whether the customer was created without identifiable information.
An array containing api call IDs related to the item.
Whether the customer has been marked as blocked, preventing the customer from making purchases.
The RevCent ID of the campaign.
The name of the campaign associated with the item.
An array containing chargeback IDs related to the item.
An array containing check direct IDs related to the item.
The unix timestamp of when the item was created.
An array of customer card objects, each being a customer card associated with the customer.
The unix timestamp of when the item was created.
The unix timestamp of when the item was updated.
The RevCent ID of the object item.
The credit card type, i.e. visa, mastercard, etc.
The last 4 digits of the customer credit card.
The credit card expiration date, formatted MM/YY.
The credit card expiration month, formatted MM.
The credit card expiration year, formatted YYYY.
Whether the credit card is the customers' default card.
An array of customer group objects, each being a customer group the customer is associated with.
The RevCent ID of the object item.
The name of the item.
An array of customer group objects, each being a customer group the customer is blocked from being associated with.
An array containing discounts related to the item.
Whether the customer is enabled and available to purchase and make payments.
An array containing fraud detection request IDs related to the item.
An array containing fraud detection IDs related to the item.
True if customer address was submitted and geocoding was successful, otherwise false.
Google place ID of customer if successfully geocoded
The RevCent ID of the object item.
The internal_id you provided when creating the item.
An array containing invoice IDs related to the item.
Geocode latitude of customer if successfully geocoded.
An array of RevCent license key ID's associated with the item.
Overall lifetime values for the customer.
The combined total of sale and subscription renewal value types.
The sum amount discounted for all sales and renewals.
The sum amount gross for all sales and renewals.
The sum amount net for all sales and renewals.
The sum amount refunded for all sales and renewals.
The sum amount remaining for all sales and renewals.
The sum amount to salvage for all sales and renewals.
The sum total volume for all sales and renewals.
The sale value type, specific to the customers' sales.
The sum amount discounted for all sales.
The sum amount gross for all sales.
The sum amount net for all sales.
The sum amount refunded for all sales.
The sum amount remaining for all sales.
The sum amount to salvage for all sales.
The sum total volume for all sales.
The total number of sales.
The average sale amount gross.
The subscription renewal value type, specific to the customers' subscription renewals.
The sum amount discounted for all subscription renewals.
The sum amount gross for all subscription renewals.
The sum amount net for all subscription renewals.
The sum amount refunded for all subscription renewals.
The sum amount remaining for all subscription renewals.
The sum amount to salvage for all subscription renewals.
The sum total volume for all subscription renewals.
The total number of subscription renewals regardless of status.
The average subscription renewal amount gross.
The total number of subscription renewals with a status of Overdue.
The fraud detection value type, specific to the customers' fraud detections.
The total amount of all fraud detections.
The total number of fraud detections.
The average fraud detection amount.
The chargeback value type, specific to the customers' chargebacks.
The total amount of all chargebacks.
The total number of chargebacks.
The average chargeback amount.
The pending refund value type, specific to the customers' pending refunds.
The total number of refunds issued to the customer.
The date of the last sale for the customer, if available.
The date of the last subscription renewal for the customer, if available.
Geocode longitude of customer if successfully geocoded.
An array containing offline payment IDs related to the item.
An array containing RevCent PayPal transaction IDs related to the item.
An array containing pending refund IDs related to the item.
An array containing product sale IDs related to the item.
The products the customer has purchased over their lifetime.
The product ID.
The product name.
The product internal ID.
The product SKU.
The total quantity for all purchases of this product by the customer.
The average price for all purchases of this product by the customer.
The total amount gross specific to the product for the customer.
The total amount refunded specific to the product for the customer.
The number of separate purchases of the product.
The individual dates, as a unix timestamp, of each purchase.
An array containing quota account IDs related to the item.
An array containing sale IDs related to the item.
An array containing salvage transaction IDs related to the item.
An array containing shipping IDs related to the item.
An array containing SMTP message IDs related to the item.
The current status of the related item.
An array containing subscription renewal IDs related to the item.
An array containing subscription IDs related to the item.
An array containing tax IDs related to the item.
An array containing credit card transaction IDs related to the item.
An array containing trial IDs related to the item.
The unix timestamp of when the item was updated.
The total number of result items for the given request.
The total number of pages for the given request.
Request JSON
{ "request": { "type": "customer", "method": "retrieve", "id": "ajOAl24bBXc5nXwagAOg" } }
Response JSON
{ "api_call_id": "X8681XdaPpfrmYgyaVAp", "api_call_processed": true, "api_call_unix": 1641919241, "code": 1, "current_count": 1, "current_page": 1, "request_method": "retrieve", "request_type": "customer", "results": [ { "address_line_1": "1600 Pennsylvania Ave", "address_line_2": "", "anonymous": false, "api_calls": [ "vEP9QdWngpUrNGW6llkv" ], "blocked": false, "campaign_id": "JN0Zpj7RGJiwKqAnRoy6", "campaign_name": "AdWords Campaign", "chargebacks": [], "check_directs": [], "city": "Washington", "company": "", "country": "USA", "created_date_unix": 1641564098, "customer_card": [ { "created_date_unix": 1641564098, "updated_date_unix": 1641746186, "id": "ALAGkvj0O7u5rdmVggQ7", "type": "visa", "last_4": "1111", "expiry_date": "11/23", "expiry_month": "11", "expiry_year": "2023", "is_default": true } ], "customer_group": [ { "id": "2rRMqP5nojF6EgJqwQVL", "name": "My Customer Group" } ], "customer_group_blocked": [], "discounts": [], "email": "georgew@whitehouse.com", "enabled": true, "first_name": "George", "fraud_detection_requests": [], "fraud_detections": [], "full_address": "1600 Pennsylvania Ave, Washington, DC 20500, USA", "geocode_success": true, "google_place_id": "ChIJGVtI4by3t4kRr51d_Qm_x58", "id": "O0O0LON20nTaNQ6gg6Lm", "internal_id": "pres_0001", "invoices": [], "last_name": "Washington", "lat": "32.5614023", "license_keys": [], "lifetime_value": { "all": { "amount_discounted": 0, "amount_gross": 363.55, "amount_net": 355.55, "amount_refunded": 0, "amount_remaining": 23.75, "amount_to_salvage": 23.75, "amount_total": 387.3 }, "sale": { "amount_discounted": 0, "amount_gross": 363.55, "amount_net": 355.55, "amount_refunded": 0, "amount_remaining": 23.75, "amount_to_salvage": 23.75, "amount_total": 387.3, "num": 1, "avg": 363.55 }, "subscription_renewal": { "amount_discounted": 0, "amount_gross": 0, "amount_net": 0, "amount_refunded": 0, "amount_remaining": 0, "amount_to_salvage": 0, "amount_total": 0, "num": 0, "avg": 0, "num_overdue": 0 }, "fraud_detection": { "amount": 0, "num": 0, "avg": 0 }, "chargeback": { "amount": 0, "num": 0, "avg": 0 }, "pending_refund": { "num": 0 }, "last_sale_date": "2022-01-07T14:01:38.458Z", "last_subscription_renewal_date": null }, "lon": "-90.19291299999999", "metadata": [ { "name": "adwords_click", "value": "Cjat0KwhCQjdTq..." } ], "notes": [ { "created_date": "2022-01-10T14:35:21+00:00", "created_date_unix": 1641825321, "updated_date": "2022-01-10T14:35:21+00:00", "updated_date_unix": 1641825321, "id": "9r0NrKQ864FaOrmOYmQn", "text": "Example customer note.", "username": "JohnDoe", "first_name": "John", "last_name": "Doe", "employee_id": "mWwZ8KyrOLNOOdbbdUbQ", "customer_note_related_type": "customer", "customer_note_related_id": "O0O0LON20nTaNQ6gg6Lm" } ], "offline_payments": [], "paypal_transactions": [], "pending_refunds": [], "phone": "12345678901", "product_sales": [ "LYG04QV82NHqzpQvLL8m" ], "products_purchased": [ { "id": "6r8O5MLbw2t6n4v1lGqK", "name": "AV 2017", "internal_id": "av_2017", "sku": "av_2017_sku", "quantity": 1, "price": 29.99, "amount_gross": 28.74, "amount_refunded": 0, "purchase_count": 1, "purchase_dates": [ 1673880787 ] } ], "quota_accounts": [], "sales": [ "6rYKpkEgmyfBaGONMMVm" ], "salvage_transactions": [ "8rkZpLd09Rf2wzVO77W5" ], "shipping": [ "l4jWlR78X5cAvvvbnlWJ" ], "smtp_messages": [], "state": "DC", "state_long": "DC", "status": "Enabled", "subscription_renewals": [], "subscriptions": [ "5rnXp2wYjRf9OzWdgg8M" ], "tax": [ "rmYb7ro28XTvmmmVE2RA" ], "transactions": [ "ZVJZkL6Kn4Cb555PnKP9" ], "trials": [ "JNvWwanZLBi8RN1ynnQR" ], "updated_date_unix": 1641825321, "zip": "20500" } ], "total_count": 1, "total_pages": 1 }
Customer Search
Search for a customer using a string or group of strings.
Please read more about API Search before proceeding.
Request JSON Schema
The main request object.
The type of request being made.
The method for the request type.
The string to search.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The API request type.
The API request method.
An array of objects, each object being a unique item.
The RevCent ID of the object item.
The unix timestamp of when the item was created.
The internal_id you provided when creating the item.
Whether the item is enabled or disabled.
Request JSON
{ "request": { "type": "customer", "method": "search", "search_term": "xbim32@gmail.com" } }
Response JSON
{ "api_call_id": "MWazbqOmazHZ5QnERONV", "api_call_processed": true, "api_call_unix": 1681160039, "code": 1, "request_type": "customer", "request_method": "search", "results": [ { "item_type": "customer", "id": "gYQYYJlMXYHXXL709WlR", "created_date_unix": 1680909458, "first_name": "zqhy", "last_name": "tyxpeqkk", "address_line_1": "1600 Pennsylvania Ave", "address_line_2": "", "city": "Washington", "state": "DC", "zip": "20500", "email": "xbim32@gmail.com", "phone": "1234567890", "internal_id": "", "ip_address": "123.456.789.0", "enabled": true, "fingerprint": "5c8b317a4bb7c91b4ade5ffc357cb6ce", "metadata": [], "url": "https://revcent.com/user/customer-details/gYQYYJlMXYHXXL709WlR", "highlights": [ { "field": "email", "values": [ "xbim32@gmail.com" ] } ], "score": 7.68 } ] }
Customer Card
A customer card is specific to a customer, and is either created automatically during an initial sale, or manually added to a customer via web app or API.
Customer Card Add
To add a customer card, use the customer > add_card API method instead. This ensures a new card is assigned to the correct customer.
If the customer does not already exist, use the customer > create API method and include the credit card details in the request.
Customer Card Enable
Enable a customer card that was previously disabled.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The RevCent customer card ID.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The RevCent ID of the customer.
The API request method.
The API request type.
The a brief description of the result of the API call.
Request JSON
{ "request": { "type": "customer_card", "method": "enable", "customer_card_id": "O0O0LON20nTaNQ6gg6Lm" } }
Response JSON
{ "api_call_id": "9r0rPLQOPATL4zXVVXrZ", "api_call_processed": true, "api_call_unix": 1641910649, "code": 1, "customer_card_id": "O0O0LON20nTaNQ6gg6Lm", "customer_id": "2rBrjB5arLtoVnPKKPMw", "request_method": "enable", "request_type": "customer_card", "result": "Customer card set to enabled." }
Customer Card Disable
Disable a customer card, preventing its use.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The RevCent customer card ID.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The RevCent ID of the customer.
The API request method.
The API request type.
The a brief description of the result of the API call.
Request JSON
{ "request": { "type": "customer_card", "method": "disable", "customer_card_id": "O0O0LON20nTaNQ6gg6Lm" } }
Response JSON
{ "api_call_id": "LYGYa9Nv7kCzL4RPPRoa", "api_call_processed": true, "api_call_unix": 1641910714, "code": 1, "customer_card_id": "O0O0LON20nTaNQ6gg6Lm", "customer_id": "2rBrjB5arLtoVnPKKPMw", "request_method": "disable", "request_type": "customer_card", "result": "Customer card set to disabled." }
Customer Card Delete
Delete a customer card, removing it from the system. This is irreversible.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The RevCent customer card ID.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The RevCent ID of the customer.
The API request method.
The API request type.
The a brief description of the result of the API call.
Request JSON
{ "request": { "type": "customer_card", "method": "delete", "customer_card_id": "O0O0LON20nTaNQ6gg6Lm" } }
Response JSON
{ "api_call_id": "ll2nVEywp2M8Mbr2vXnf", "api_call_processed": true, "api_call_unix": 1641910772, "code": 1, "customer_card_id": "O0O0LON20nTaNQ6gg6Lm", "customer_id": "2rBrjB5arLtoVnPKKPMw", "request_method": "delete", "request_type": "customer_card", "result": "Customer card deleted." }
Customer Card Set Default
Set a customer card as the default card for the customer.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The RevCent customer card ID.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The RevCent ID of the customer.
The API request method.
The API request type.
The a brief description of the result of the API call.
Request JSON
{ "request": { "type": "customer_card", "method": "set_default", "customer_card_id": "O0O0LON20nTaNQ6gg6Lm" } }
Response JSON
{ "api_call_id": "EM8Mbr2vXnfywp2ll2nV", "api_call_processed": true, "api_call_unix": 1641910772, "code": 1, "customer_card_id": "O0O0LON20nTaNQ6gg6Lm", "customer_id": "2rBrjB5arLtoVnPKKPMw", "request_method": "set_default", "request_type": "customer_card", "result": "Customer card set as default." }
Customer Card Retrieve
Retrieve current information on a single customer card or multiple customer cards. To view all cards for a specific customer, simply use the customer > retrieve method, using the customer ID, which will contain the customers' cards in the response.
Please view Pagination and Filters for details on retrieving multiple items.
The response may include AdWords Response Objects within each item if an AdWords click ID is associated with the item.
Request JSON Schema
The main request object.
The type of request being made.
The method for the request type.
The RevCent ID of the item. Required if multiple property equals false or is not present.
Whether it is a multiple type request.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The number of result items contained in the current page.
The current page of result, same as requested page, default is page 1.
The API request method.
The API request type.
An array of objects, each object being a unique item.
The unix timestamp of when the item was created.
The customer object.
The customers' first address line.
The customers' second address line.
Whether the customer has been blocked from purchases.
The customers' city.
The customers' company.
The customers' country.
The customers' email.
Whether the customer is currently enabled.
The customers' first name.
The customers' full address.
Whether the customers' address was successfully geocoded using the Google geocoding service.
The Google place ID for the customers' address using the Google geocoding service.
The RevCent ID for the customer.
Your internal ID for the customer.
The customers' last name.
The approximate latitude for the customers' address using the Google geocoding service.
The approximate longitude for the customers' address using the Google geocoding service.
The customers' phone number.
The customers' state.
The customers' state in long format.
The customers' status.
The customers' zip or postal code.
Whether the item is enabled or disabled.
The expiration date of the customer card formatted M/YYYY.
The expiration date of the customer card formatted MM/YYYY.
The expiration date of the customer card formatted MM.
The expiration year of the customer card formatted YYYY.
The first 6 digits of the customer card number.
The RevCent ID of the object item.
Whether the card is the customers' default card.
The last 4 digits of the customer card number.
Whether the item was created using a live or test RevCent API key.
The credit card type. I.e. visa, mastercard, etc.
The unix timestamp of when the item was updated.
The total number of result items for the given request.
The total number of pages for the given request.
Request JSON
{ "request": { "type": "customer_card", "method": "retrieve", "id": "O0O0LON20nTaNQ6gg6Lm" } }
Response JSON
{ "api_call_id": "Wm0m9Y2K5YuXrgdvmMAL", "api_call_processed": true, "api_call_unix": 1641910867, "code": 1, "current_count": 1, "current_page": 1, "request_method": "retrieve", "request_type": "customer_card", "results": [ { "created_date_unix": 1641910298, "customer": { "address_line_1": "1600 Pennsylvania Ave", "address_line_2": "", "blocked": false, "city": "Washington", "company": "", "country": "USA", "email": "georgew@whitehouse.com", "enabled": true, "first_name": "George", "full_address": "1600 Pennsylvania Ave NW, Washington, DC 20500, USA", "geocode_success": true, "google_place_id": "ChIJGVtI4by3t4kRr51d_Qm_x58", "id": "4r158EzJmmcVM69dNLkg", "internal_id": "pres_0001", "last_name": "Washington", "lat": "38.8976633", "lon": "-77.0365739", "metadata": [], "phone": "1234567890", "state": "DC", "state_long": "DC", "zip": "20500" }, "enabled": false, "expiry_date": "11/2023", "expiry_month": "11", "expiry_year": "2023", "first_6": "424242", "id": "O0O0LON20nTaNQ6gg6Lm", "is_default": true, "last_4": "4242", "live_mode": false, "type": "visa", "updated_date_unix": 1641910714 } ], "total_count": 1, "total_pages": 1 }
Discount
A discount is created when RevCent receives a static discount entry or a coupon code during a request.
Discount Retrieve
Retrieve current information on a single discount or multiple discounts.
Please view Pagination and Filters for details on retrieving multiple items.
The response may include AdWords Response Objects within each item if an AdWords click ID is associated with the item.
Request JSON Schema
The main request object.
The type of request being made.
The method for the request type.
The RevCent ID of the item. Required if multiple property equals false or is not present.
Whether it is a multiple type request.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The number of result items contained in the current page.
The current page of result, same as requested page, default is page 1.
The API request method.
The API request type.
An array of objects, each object being a unique item.
An array containing check direct IDs related to the item.
The details of any coupon related to the discount.
The RevCent ID of the object item.
The name of the item.
The description of the item.
The coupon code.
The unix timestamp of when the item was created.
The customer object.
The customers' first address line.
The customers' second address line.
Whether the customer has been blocked from purchases.
The customers' city.
The customers' company.
The customers' country.
The customers' email.
Whether the customer is currently enabled.
The customers' first name.
The customers' full address.
Whether the customers' address was successfully geocoded using the Google geocoding service.
The Google place ID for the customers' address using the Google geocoding service.
The RevCent ID for the customer.
Your internal ID for the customer.
The customers' last name.
The approximate latitude for the customers' address using the Google geocoding service.
The approximate longitude for the customers' address using the Google geocoding service.
The customers' phone number.
The customers' state.
The customers' state in long format.
The customers' status.
The customers' zip or postal code.
The description of the item.
The total discount amount applied.
The percentage of total request amount before discount is applied.
The discount type corresponds to discount amount. Default is amount.
The RevCent ID of the object item.
The name of the item.
An array containing offline payment IDs related to the item.
An array containing RevCent PayPal transaction IDs related to the item.
An array containing pending refund IDs related to the item.
An array containing product sale IDs related to the item.
An array containing sale IDs related to the item.
An array containing salvage transaction IDs related to the item.
An array containing shipping IDs related to the item.
An array containing SMTP message IDs related to the item.
An array containing subscription renewal IDs related to the item.
An array containing subscription IDs related to the item.
An array containing tax IDs related to the item.
Will contain details if the root item is related to a third party shop.
The RevCent ID of the object item.
The name of the item.
The URL of the third party shop.
An array containing credit card transaction IDs related to the item.
An array containing trial IDs related to the item.
The unix timestamp of when the item was updated.
The total number of result items for the given request.
The total number of pages for the given request.
Request JSON
{ "request": { "type": "discount", "method": "retrieve", "id": "5r1wN8EbAgsPvLlbMava" } }
Response JSON
{ "api_call_id": "ZVE5YRjd7RsXZpVw4krG", "api_call_processed": true, "api_call_unix": 1566160507, "code": 1, "current_count": 1, "current_page": 1, "request_method": "retrieve", "request_type": "discount", "results": [ { "check_directs": [], "coupon": { "id": "VPmmrpbVl7cQ9JaXEanl", "name": "test2", "description": "", "coupon_code": "10percent" }, "created_date_unix": 1565965034, "customer": { "address_line_1": "1600 Pennsylvania Ave", "address_line_2": "", "blocked": false, "city": "Washington", "company": "", "country": "USA", "email": "georgew@whitehouse.com", "enabled": true, "first_name": "George", "full_address": "1600 Pennsylvania Ave NW, Washington, DC 20500, USA", "geocode_success": true, "google_place_id": "ChIJGVtI4by3t4kRr51d_Qm_x58", "id": "4r158EzJmmcVM69dNLkg", "internal_id": "pres_0001", "last_name": "Washington", "lat": "38.8976633", "lon": "-77.0365739", "metadata": [], "phone": "1234567890", "state": "DC", "state_long": "DC", "zip": "20500" }, "description": "$5 Off Coupon from facebook link.", "discount_amount": 5, "discount_percent": 4.17, "discount_type": "amount", "id": "5r1wN8EbAgsPvLlbMava", "name": "$5 Off Coupon", "notes": [], "offline_payments": [], "paypal_transactions": [], "pending_refunds": [], "product_sales": [], "sales": [ "Kn5aKb8lQZfXMl0NGjRZ" ], "salvage_transactions": [], "shipping": [], "smtp_messages": [], "subscription_renewals": [], "subscriptions": [], "tax": [], "third_party_shop": { "id": "Q48aAbVv21fJRvNKWrvP", "name": "My Shop" }, "transactions": [], "trials": [], "updated_date_unix": 1565965035 } ], "total_count": 1, "total_pages": 1 }
Fraud
RevCent fraud alerts, fraud detections and fraud detection requests, using manual or third party integrations. Please read carefully about the difference between a fraud alert and a fraud detection.
Fraud Alert
A fraud alert is simply an indicator that a sale may or may not be fraud and needs manual review. An alert can be removed if the sale is determined to not be fraud.
Fraud Alert Add
Mark a sale with a fraud alert.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The RevCent ID of the sale.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The RevCent ID of the campaign.
The name of the campaign associated with the item.
The result code for the request.
0 = RevCent Error
1 = Success
The RevCent ID of the customer.
The API request method.
The API request type.
The a brief description of the result of the API call.
The RevCent ID of the sale.
Request JSON
{ "request": { "type": "fraud_alert", "method": "add", "sale_id": "2rnYMVFGraRJBnPpgvQV" } }
Response JSON
{ "api_call_id": "y2WG1ApMMKhW6ZoBb72o", "api_call_processed": true, "api_call_unix": 1609086154, "campaign_id": "mJ1zZoOobEuP8pnWKXd1", "campaign_name": "Adwords Campaign", "code": 1, "customer_id": "9rZ68zWWglFY8O26azRX", "request_method": "add", "request_type": "fraud_alert", "result": "Fraud alert added to sale.", "sale_id": "2rnYMVFGraRJBnPpgvQV" }
Fraud Alert Remove
Remove an existing fraud alert from a sale.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The RevCent ID of the sale.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The RevCent ID of the campaign.
The name of the campaign associated with the item.
The result code for the request.
0 = RevCent Error
1 = Success
The RevCent ID of the customer.
The API request method.
The API request type.
The a brief description of the result of the API call.
The RevCent ID of the sale.
Request JSON
{ "request": { "type": "fraud_alert", "method": "remove", "sale_id": "2rnYMVFGraRJBnPpgvQV" } }
Response JSON
{ "api_call_id": "qZM6vXNEVasgj0XVJO50", "api_call_processed": true, "api_call_unix": 1609118598, "code": 1, "customer_id": "9rZ68zWWglFY8O26azRX", "request_method": "remove", "request_type": "fraud_alert", "result": "Fraud alert removed from sale.", "sale_id": "2rnYMVFGraRJBnPpgvQV" }
Fraud Detection
A fraud detection is confirmation that an item is indeed fraud. Once created it cannot be removed or un-done. You can create a fraud detection using either the API, or via a third party integration, for credit card, PayPal, checks or offline payments.
Fraud Detection Create
Create a fraud detection within RevCent via the fraud detection create method.
Important: A fraud detection must have an originating RevCent API call, which RevCent will find when you provide a value for source_id. The value for the source_id property can be from one of the items listed below.
- API Call ID
- The RevCent ID for the originating API call.
- Sale ID
- The RevCent ID for a sale.
- Transaction ID
- The RevCent ID for a credit card transaction.
- Gateway Transaction ID
- The payment gateways' ID for a credit card transaction.
- PayPal Transaction ID
- The RevCent ID or PayPal ID for a PayPal transaction.
- Check ID
- The RevCent ID for a check payment.
- Offline Payment ID
- The RevCent ID for an offline payment.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The source ID. Read the important information above.
You can choose to automatically void the sale, by setting to true, if source_id is a RevCent sale ID. Default is false. Note: This will fully refund all entities of the sale and cannot be undone.
You can choose to have RevCent add fraud alerts to similar sales. Default is false.
The acquirer reference number.
The date of the fraud event.
The date the fraud was detected.
The case number.
The RevCent third party integration ID.
The third party fraud detection ID.
The third party order ID.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The RevCent ID of the campaign.
The name of the campaign associated with the item.
The result code for the request.
0 = RevCent Error
1 = Success
The RevCent ID of the customer.
The RevCent IDs of each fraud detection created as a result of the API call.
The RevCent ID of the original API call that created the entity associated with the fraud.
The API request method.
The API request type.
The a brief description of the result of the API call.
Whether the sale was simultaneously voided along with the fraud detection creation.
Request JSON
{ "request": { "type": "fraud_detection", "method": "create", "source_id": "2rnYMVFGraRJBnPpgvQV", "void_sale": false, "flag_similar_sale": false, "arn": "93994", "event_date": "12/01/2020", "fraud_detection_date": "12/11/2020", "case_number": "4999", "third_party_integration_id": "8r4lFWLbEr1PZglb7d8z", "third_party_fraud_detection_id": "123456", "third_party_order_id": "00001", "metadata": [ { "name": "fraud", "value": "12345" } ] } }
Response JSON
{ "api_call_id": "y2WG1ApMMKhW6ZoBb72o", "api_call_processed": true, "api_call_unix": 1609086154, "campaign_id": "mJ1zZoOobEuP8pnWKXd1", "campaign_name": "Adwords Campaign", "code": 1, "customer_id": "9rZ68zWWglFY8O26azRX", "fraud_detection_created": [ "VPwOydX2ArHJy8gX2o98" ], "origin_api_call_id": "O04EbzqqdltXb7EOGQpz", "request_method": "create", "request_type": "fraud_detection", "result": "Fraud detection created.", "void_sale": false }
Fraud Detection Edit
Edit an existing fraud detection within RevCent via the fraud detection edit method.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The RevCent ID of the fraud detection.
The amount of the related transaction associated with the fraud detection.
The acquirer reference number, if applicable.
The date of the fraud event.
The date the fraud was detected.
The case number, if applicable.
Whether the fraud detection is incorrect. I.e. The related payment is not actually fraud.
The RevCent third party integration ID.
The third party fraud detection ID.
The third party order ID.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The RevCent ID of the fraud detection.
The API request method.
The API request type.
The a brief description of the result of the API call.
Request JSON
{ "request": { "type": "fraud_detection", "method": "edit", "fraud_detection_id": "LYklEVoPJLfq65rR290A", "amount": 140, "arn": "93995", "event_date": "12/29/2020", "fraud_detection_date": "12/30/2020", "case_number": "5000", "false_positive": true, "third_party_integration_id": "8r4lFWLbEr1PZglb7d8z", "third_party_fraud_detection_id": "7890", "third_party_order_id": "00002" } }
Response JSON
{ "api_call_id": "qZM6vXNEVasgj0XVJO50", "api_call_processed": true, "api_call_unix": 1609118598, "code": 1, "fraud_detection_id": "LYklEVoPJLfq65rR290A", "request_method": "edit", "request_type": "fraud_detection", "result": "Fraud detection edited." }
Fraud Detection Retrieve
Retrieve current information on a single fraud detection or multiple fraud detections.
Please view Pagination and Filters for details on retrieving multiple items.
Request JSON Schema
The main request object.
The type of request being made.
The method for the request type.
The RevCent ID of the item. Required if multiple property equals false or is not present.
Whether it is a multiple type request.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The number of result items contained in the current page.
The current page of result, same as requested page, default is page 1.
The API request method.
The API request type.
An array of objects, each object being a unique item.
The amount of the transaction associated with the fraud detection.
The acquirer reference number, if applicable.
The RevCent ID of the campaign.
The name of the campaign associated with the item.
The case number, if applicable.
An array containing chargeback IDs related to the item.
An array containing check direct IDs related to the item.
The unix timestamp of when the item was created.
The customer object.
The customers' first address line.
The customers' second address line.
Whether the customer has been blocked from purchases.
The customers' city.
The customers' company.
The customers' country.
The customers' email.
Whether the customer is currently enabled.
The customers' first name.
The customers' full address.
Whether the customers' address was successfully geocoded using the Google geocoding service.
The Google place ID for the customers' address using the Google geocoding service.
The RevCent ID for the customer.
Your internal ID for the customer.
The customers' last name.
The approximate latitude for the customers' address using the Google geocoding service.
The approximate longitude for the customers' address using the Google geocoding service.
The customers' phone number.
The customers' state.
The customers' state in long format.
The customers' status.
The customers' zip or postal code.
An array containing discounts related to the item.
The date of the fraud event.
The unix timestamp of the date of the fraud event.
Whether the fraud detection is incorrect. I.e. The related payment is not actually fraud.
The date the fraud was detected.
The unix timestamp of the date the fraud was detected.
An array containing fraud detection request IDs related to the item.
The RevCent ID of the object item.
An array containing invoice IDs related to the item.
Whether the fraud detection is associated with a RevCent third party integration.
ISO 4217 currency code.
Whether the item was created using a live or test RevCent API key.
An array containing offline payment IDs related to the item.
The original API call that created the entity associated with the fraud detection.
The RevCent ID of the original API call that created the entity associated with the fraud.
The date of the API call.
The unix timestamp of the date of the API call.
The API call type.
The API call method.
The IP address that was used to make the API call.
The payment type related to the item.
The system ID of the payment type related to the item.
The system name of the payment type related to the item.
An array containing RevCent PayPal transaction IDs related to the item.
An array containing pending refund IDs related to the item.
An array containing product sale IDs related to the item.
The RevCent hosted shopping cart that item originated from.
The RevCent ID of the sale.
An array containing sale IDs related to the item.
An array containing salvage transaction IDs related to the item.
An array containing shipping IDs related to the item.
The current status of the related item.
An array containing subscription renewal IDs related to the item.
An array containing subscription IDs related to the item.
An array containing tax IDs related to the item.
The third party fraud detection ID.
If the fraud detection was created by a third party integration, details will appear here.
The ID of your RevCent third party integration.
The name of your RevCent third party integration.
Details on the specific third party.
The RevCent ID for the third party.
The name of the third party.
The third party order ID.
The third party shop related to the item.
An array containing credit card transaction IDs related to the item.
An array containing trial IDs related to the item.
The unix timestamp of when the item was updated.
An array containing usage account invoice IDs related to the item.
An array containing usage account IDs related to the item.
An array containing usage item invoice IDs related to the item.
An array containing usage item IDs related to the item.
The total number of result items for the given request.
The total number of pages for the given request.
Request JSON
{ "request": { "type": "fraud_detection", "method": "retrieve", "id": "d9bmzA9lr8tYJAyLkBZO" } }
Response JSON
{ "api_call_id": "BvGBOZ2k14cXbZ1AvE17", "api_call_processed": true, "api_call_unix": 1609092655, "code": 1, "current_count": 1, "current_page": 1, "request_method": "retrieve", "request_type": "fraud_detection", "results": [ { "amount": 21.61, "arn": "arn234", "campaign_id": "mJ1zZoOobEuP8pnWKXd1", "campaign_name": "Adwords Campaign", "case_number": "fraud123", "chargebacks": [], "check_directs": [], "created_date_unix": 1609086154, "customer": { "address_line_1": "1600 Pennsylvania Ave", "address_line_2": "", "blocked": false, "city": "Washington", "company": "", "country": "USA", "email": "georgew@whitehouse.com", "enabled": true, "first_name": "George", "full_address": "1600 Pennsylvania Ave NW, Washington, DC 20500, USA", "geocode_success": true, "google_place_id": "ChIJGVtI4by3t4kRr51d_Qm_x58", "id": "4r158EzJmmcVM69dNLkg", "internal_id": "pres_0001", "last_name": "Washington", "lat": "38.8976633", "lon": "-77.0365739", "metadata": [], "phone": "1234567890", "state": "DC", "state_long": "DC", "zip": "20500" }, "details_response": "{}", "discounts": [], "event_date": "2020-12-01T00:00:00+00:00", "event_date_unix": 1606780800, "false_positive": false, "fraud_detection_date": "2020-12-11T00:00:00+00:00", "fraud_detection_date_unix": 1607644800, "fraud_detection_requests": [], "id": "VPwOydX2ArHJy8gX2o98", "invoices": [], "is_third_party_integration": true, "iso_currency": "USD", "license_keys": [], "live_mode": false, "metadata": [ { "name": "fraud", "value": "12345", "entry_date": "2020-12-27" } ], "notes": [], "offline_payments": [], "origin_api_call": { "id": "O04EbzqqdltXb7EOGQpz", "date": "2020-12-27T16:20:24+00:00", "date_unix": 1609086024, "type": "sale", "method": "create", "ip_address": "123.456.789.101" }, "payment_type": { "id": "KnQ0KlNE6kf5mobyV0pN", "name": "Credit Card" }, "paypal_transactions": [], "pending_refunds": [], "product_sales": [ "zGkMgj2aKPhWBbNqdGjG" ], "quota_accounts": [], "revcent_shop": null, "sale_id": "BvGqjz00dlT2jEk65OnW", "sales": [ "BvGqjz00dlT2jEk65OnW" ], "salvage_transactions": [], "shipping": [ "d9bgVWPpEvFwBW29R8jP" ], "smtp_messages": [], "status": "Created", "subscription_renewals": [], "subscriptions": [], "tax": [ "pgPZnmRpYkf710aQ8jRA" ], "third_party_fraud_detection_id": "third_party_id123", "third_party_integration": { "id": "8r4Er1PZglFWLblb7d8z", "name": "Midigator Prevention", "third_party": { "id": "zGkz8XvX9yT48q6LRqjW", "name": "Midigator Prevention" } }, "third_party_order_id": "third_party_order_id4342", "third_party_shop": null, "transactions": [ "2rnPpgvYMVFGraRJBnQV" ], "trials": [], "updated_date_unix": 1609086154, "usage_account_invoices": [], "usage_accounts": [], "usage_item_entries": [], "usage_item_invoices": [], "usage_items": [] } ], "total_count": 1, "total_pages": 1 }
Fraud Detection Request
A fraud detection request within RevCent is created when RevCent contacts a third party integration and requests information on a payment before the payment is processed.
Fraud Detection Request Retrieve
Retrieve current information on a single fraud detection request or multiple fraud detection requests.
Please view Pagination and Filters for details on retrieving multiple items.
Request JSON Schema
The main request object.
The type of request being made.
The method for the request type.
The RevCent ID of the item. Required if multiple property equals false or is not present.
Whether it is a multiple type request.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The number of result items contained in the current page.
The current page of result, same as requested page, default is page 1.
The API request method.
The API request type.
An array of objects, each object being a unique item.
The RevCent ID of the campaign.
The name of the campaign associated with the item.
An array containing chargeback IDs related to the item.
An array containing check direct IDs related to the item.
The unix timestamp of when the item was created.
The customer object.
The customers' first address line.
The customers' second address line.
Whether the customer has been blocked from purchases.
The customers' city.
The customers' company.
The customers' country.
The customers' email.
Whether the customer is currently enabled.
The customers' first name.
The customers' full address.
Whether the customers' address was successfully geocoded using the Google geocoding service.
The Google place ID for the customers' address using the Google geocoding service.
The RevCent ID for the customer.
Your internal ID for the customer.
The customers' last name.
The approximate latitude for the customers' address using the Google geocoding service.
The approximate longitude for the customers' address using the Google geocoding service.
The customers' phone number.
The customers' state.
The customers' state in long format.
The customers' status.
The customers' zip or postal code.
An array containing discounts related to the item.
An array containing fraud detection IDs related to the item.
The RevCent ID of the object item.
The third party integration mode, i.e. live or test.
An array containing invoice IDs related to the item.
Whether the request resulted in an error.
Whether the fraud detection request resulted in a fraud detection.
When the fraud detection request allowed the source payment to be processed.
Whether the request was sent to a third party integration.
ISO 4217 currency code.
An array of RevCent license key ID's associated with the item.
Whether the item was created using a live or test RevCent API key.
An array containing offline payment IDs related to the item.
The payment type related to the item.
The system ID of the payment type related to the item.
The system name of the payment type related to the item.
An array containing RevCent PayPal transaction IDs related to the item.
An array containing pending refund IDs related to the item.
An array containing product sale IDs related to the item.
An array containing quota account IDs related to the item.
The raw response returned from the third party when originally contacted.
The RevCent hosted shopping cart that item originated from.
The RevCent ID of the sale.
An array containing sale IDs related to the item.
An array containing salvage transaction IDs related to the item.
An array containing shipping IDs related to the item.
An array containing SMTP message IDs related to the item.
The current status of the related item.
An array containing subscription renewal IDs related to the item.
An array containing subscription IDs related to the item.
An array containing tax IDs related to the item.
The third party ID for the request.
Third party integration.
The ID of your RevCent third party integration.
The name of your RevCent third party integration.
Details on the specific third party.
The RevCent ID for the third party.
The name of the third party.
The third party shop related to the item.
An array containing credit card transaction IDs related to the item.
An array containing trial IDs related to the item.
The unix timestamp of when the item was updated.
An array containing usage account invoice IDs related to the item.
An array containing usage account IDs related to the item.
An array containing usage item entry IDs related to the item.
An array containing usage item invoice IDs related to the item.
An array containing usage item IDs related to the item.
The total number of result items for the given request.
The total number of pages for the given request.
Request JSON
{ "request": { "type": "fraud_detection_request", "method": "retrieve", "id": "RJ8a2blwBlFbbwPppNZA" } }
Response JSON
{ "api_call_id": "j08r887w1ahVE88gl0z5", "api_call_processed": true, "api_call_unix": 1611257424, "code": 1, "current_count": 1, "current_page": 1, "request_method": "retrieve", "request_type": "fraud_detection_request", "results": [ { "campaign_id": "mJ1zZoOobEuP8pnWKXd1", "campaign_name": "Adwords Campaign", "chargebacks": [], "check_directs": [], "created_date_unix": 1611181895, "customer": { "address_line_1": "1600 Pennsylvania Ave", "address_line_2": "", "blocked": false, "city": "Washington", "company": "", "country": "USA", "email": "georgew@whitehouse.com", "enabled": true, "first_name": "George", "full_address": "1600 Pennsylvania Ave NW, Washington, DC 20500, USA", "geocode_success": true, "google_place_id": "ChIJGVtI4by3t4kRr51d_Qm_x58", "id": "4r158EzJmmcVM69dNLkg", "internal_id": "pres_0001", "last_name": "Washington", "lat": "38.8976633", "lon": "-77.0365739", "metadata": [], "phone": "1234567890", "state": "DC", "state_long": "DC", "zip": "20500" }, "discounts": [], "fraud_detections": [], "id": "RJ8a2blwBlFbbwPppNZA", "integration_mode": "Test", "invoices": [], "is_error": false, "is_fraud_detected": false, "is_payment_allowed": true, "is_third_party_integration": true, "iso_currency": "USD", "license_keys": [], "live_mode": false, "metadata": [ { "name": "kount_session_id", "value": "c8ed4debf8f242be972c1071731052e8", "entry_date": "2021-01-20" } ], "notes": [], "offline_payments": [], "payment_type": { "id": "KnQ0KlNE6kf5mobyV0pN", "name": "Credit Card" }, "paypal_transactions": [], "pending_refunds": [], "product_sales": [ "Wmv2Bb1nOdu55kl22JKV" ], "quota_accounts": [], "raw_response": "", "revcent_shop": null, "sale_id": "Nk4OV6Wdm5INNEPXXVr7", "sales": [ "Nk4OV6Wdm5INNEPXXVr7" ], "salvage_transactions": [], "shipping": [ "0pKAO9JoNYFrrNall7Xp" ], "smtp_messages": [], "status": "Success", "subscription_renewals": [], "subscriptions": [], "tax": [ "k6a8rV2nw9FLLO9GGXvy" ], "third_party_fraud_detection_id": "DWKW0YW258ZM", "third_party_integration": { "id": "ajYRoLokyXf62qy06JpZ", "name": "Kount Risk Inquiry", "third_party": { "id": "mJEZdyVavzUL0gGoLR1Z", "name": "Kount" } }, "third_party_shop": null, "transactions": [ "zGWVMkz0m0h22EMLL61r" ], "trials": [], "updated_date_unix": 1611181898, "usage_account_invoices": [], "usage_accounts": [], "usage_item_entries": [], "usage_item_invoices": [], "usage_items": [] } ], "total_count": 1, "total_pages": 1 }
Gateway
RevCent has different gateway entities. The site gateway, user gateway and gateway group. Each play a different role in the credit card processing system in RevCent.
We highly recommend that you read the documentation carefully to distinguish the difference between each one.
Site Gateway
A site gateway is where RevCent will ultimately send transactions. You create a user gateway based on a site gateway.
Site Gateway Retrieve
Retrieve current information on a single site gateway or multiple site gateways. This is the list of available gateways within the RevCent system. The most important part is the fields array, which is what each gateway requires for authentication.
Please view Pagination and Filters for details on retrieving multiple items.
Request JSON Schema
The main request object.
The type of request being made.
The method for the request type.
The RevCent ID of the item. Required if multiple property equals false or is not present.
Whether it is a multiple type request.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The number of result items contained in the current page.
The current page of result, same as requested page, default is page 1.
The API request method.
The API request type.
An array of objects, each object being a unique item.
The description of the item.
The RevCent ID of the object item.
The name of the item.
The description of the item.
The RevCent ID of the object item.
The name of the item.
The total number of result items for the given request.
The total number of pages for the given request.
Request JSON
{ "request": { "type": "site_gateway", "method": "retrieve", "id": "dXAmybdWwYHrLyWRAAZV", "multiple": false, "filters": { "limit": 100, "page": 1 } } }
Response JSON
{ "api_call_id": "8ry1n98aGMIvjrlKrKQo", "api_call_processed": true, "api_call_unix": 1676475629, "code": 1, "current_count": 1, "current_page": 1, "request_method": "retrieve", "request_type": "site_gateway", "results": [ { "description": "Authorize.net Merchant Gateway", "fields": [ { "id": "1", "name": "API Login ID", "description": "Authorize.net API Login ID" }, { "id": "2", "name": "Transaction Key", "description": "Authorize.net Transaction Key" } ], "id": "dXAmybdWwYHrLyWRAAZV", "name": "Authorize.net" } ], "total_count": 1, "total_pages": 1 }
User Gateway
A user gateway is essentially a MID, where you provide your credentials (fields) according to the site gateway. You create a user gateway based on a site gateway. For example, if you are creating a user gateway (MID) for Authorize.net, you would need to supply the correct number of fields, including each fields' corresponding id and value when creating the user gateway. Read more about User Gateways .
User Gateway Create
Create a user gateway within RevCent via the user gateway create method.
Important: A site gateway is required, along with the correct required fields when creating a user gateway.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The name of the item.
The description of the item.
Whether the gateway should be enabled or disabled.
The transaction success fee for the user gateway. Default is 0.
The transaction fail fee for the user gateway. Default is 0.
The discount rate for the user gateway. Default is 0.
The site gateway ID that the user gateway will communicate with.
The merchant account ID for the user gateway.
The custom descriptor for the user gateway. Will be provided to supported gateways as well as provided as shortcodes in email templates.
Whether to enable the custom descriptor.
The custom descriptor name.
The custom descriptor email.
The custom descriptor URL.
The custom descriptor phone.
The custom descriptor address.
The custom descriptor city.
The custom descriptor state.
The custom descriptor postal code.
Whether to enable global cascade rules, which will overwrite individual profile cascade rules across all payment profiles for this gateway. More info about how a cascade works within a payment profile at our Knowledge Base.
Whether to enable global cascade rules for the user gateway.
Revenue rules are specific to the gateway, and allow or disallow the use of the gateway based on payment volume, occurrences and more. You can add multiple revenue rules to a gateway within the cascade. Read More
Whether revenue rules are enabled.
An array of individual revenue rules.
Whether the specific revenue rule is enabled.
The rule bounds to declare if a rule passes or fails.
- min: The final calculation value must be greater than the Rule Value.
- max: The final calculation value must be less than the Rule Value.
The rule value is compared with the calculation value and bound.
The source, in combination with the source value and calculation, is what is used to form the calculation value.
- gateway: Transactions only from the specific gateway the rule is within.
- global: All transactions regardless of gateway.
- step: The active step being processed during the payment flow.
The source value is specific to the source selected.
- captured: Only transactions which were captured.
- declined: Only transactions which were declined.
- chargeback: Only transactions which were marked as charged back.
- total: All transactions regardless of outcome or status.
- amount: Applicable only when source is 'Active Step'. The amount for the active step being processed during the payment flow.
The calculation to perform based on the source value.
- count: The total number of source value items.
- percent: The percentage of source value items.
- sum: The sum of all source value items.
The total amount of time the rule applies in a past time range.
The time unit. Used in conjunction with the time value.
- hour: Time value as hours.
- day: Time value as days.
- week: Time value as weeks.
- month: Time value as months.
Time rules are specific to the gateway, and allow or disallow the use of the gateway based on time settings. All time rules are GMT (UTC+0). Read More
Whether time rules are enabled.
An array of individual time rules.
Whether the specific time rule is enabled.
The start time, formatted as hh:mm:a
The end time, formatted as hh:mm:a
The specific weekday that the time rule applies.
- monday
- tuesday
- wednesday
- thursday
- friday
- saturday
- sunday
Whether to allow or deny the gateway from processing the step transaction based on the current GMT time and the rule day and time ranges.
- allow: Allow the gateway to process the step transaction if current GMT time and day are within the day and time ranges.
- deny: Do not allow the gateway to process the step transaction if current GMT time and day are within the day and time ranges.
The fields required for the user gateway based on the id of the site gateway fields.
The id for the individual field according to the site gateway fields required.
The value for the individual field according to the site gateway fields required.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The unix timestamp of when the item was created.
Whether the item is enabled or disabled.
The name of the item.
The description of the item.
Whether the item is enabled or disabled.
Whether the item is enabled or disabled.
Whether the item is enabled or disabled.
Whether the item is enabled or disabled.
The name of the item.
Whether the item is enabled or disabled.
Whether the item is enabled or disabled.
The RevCent ID of the object item.
The merchant account ID associated with the merchant gateway.
The name of the item.
The API request method.
The API request type.
The a brief description of the result of the API call.
The RevCent ID of the object item.
The name of the item.
The unix timestamp of when the item was updated.
Request JSON
{ "request": { "type": "user_gateway", "method": "create", "name": "Authorize.net", "user_gateway_id": "LYE26MW8Rlh5VbJmlp2l", "description": "My awesome gateway.", "enabled": true, "merchant_account_id": "845678", "transaction_success_fee": 0.55, "transaction_fail_fee": 0.65, "discount_rate": 2.71, "site_gateway_id": "dXAmybdWwYHrLyWRAAZV", "custom_descriptor": { "enabled": true, "name": "Acme Org", "email": "email@acme.org", "url": "https://www.acme.org", "phone": "867-5399", "address": "1600 Pennsylvania Ave", "city": "Washington", "state": "DC", "postal_code": "20500" }, "global_cascade_rules": { "enabled": true, "revenue_rules": { "enabled": true, "options": [ { "enabled": true, "bound": "max", "rule_value": 5, "calculation": "count", "source": "gateway", "source_value": "chargeback", "time_value": 1, "time_unit": "month" } ] }, "time_rules": { "enabled": true, "options": [ { "start_time": "12:00am", "end_time": "11:59pm", "name": "sunday", "option": "deny", "enabled": true } ] } }, "fields": [ { "id": "1", "value": "ABCD123" }, { "id": "2", "value": "456efG789" } ] } }
Response JSON
{ "api_call_date": "2023-02-15T15:38:07+00:00", "api_call_id": "qZ90JMnBEBSOzznaldPj", "api_call_processed": true, "api_call_unix": 1676475487, "code": 1, "created_date": "2017-11-10T13:29:38+00:00", "created_date_unix": 1510320578, "custom_descriptor": { "enabled": true, "name": "Acme Org", "email": "email@acme.org", "url": "https://www.acme.org", "phone": "867-5399", "address": "1600 Pennsylvania Ave", "city": "Washington", "state": "DC", "postal_code": "20500" }, "description": "Auth.net", "discount_rate": 2.5, "enabled": true, "gateway_group": [], "global_cascade_rules": { "revenue_rules": { "enabled": true, "options": [ { "enabled": true, "bound": "max", "rule_value": 5, "calculation": "count", "source": "gateway", "source_value": "chargeback", "time_unit": "month", "time_value": 1 } ] }, "time_rules": { "enabled": true, "options": [ { "start_time": "12:00am", "end_time": "11:59pm", "name": "sunday", "option": "deny", "enabled": true } ] }, "enabled": true }, "id": "LYE26MW8Rlh5VbJmlp2l", "merchant_account_id": "845678", "name": "Authorize.net", "request_method": "create", "request_type": "user_gateway", "result": "Gateway created.", "site_gateway": { "id": "dXAmybdWwYHrLyWRAAZV", "name": "Authorize.net" }, "transaction_fail_fee": 0.15, "transaction_success_fee": 0.25, "updated_date": "2023-02-15T15:38:07+00:00", "updated_date_unix": 1676475487 }
User Gateway Edit
Edit an existing user gateway within RevCent via the user gateway edit method.
Note: Only provide the properties you wish to modify. Properties not provided will remain unchanged.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The name of the item.
The user gateway ID
The description of the item.
Whether the gateway should be enabled or disabled.
The transaction success fee for the user gateway. Default is 0.
The transaction fail fee for the user gateway. Default is 0.
The discount rate for the user gateway. Default is 0.
The site gateway ID that the user gateway will communicate with.
The merchant account ID for the user gateway.
The custom descriptor for the user gateway. Will be provided to supported gateways as well as provided as shortcodes in email templates.
Whether to enable the custom descriptor.
The custom descriptor name.
The custom descriptor email.
The custom descriptor URL.
The custom descriptor phone.
The custom descriptor address.
The custom descriptor city.
The custom descriptor state.
The custom descriptor postal code.
Whether to enable global cascade rules, which will overwrite individual profile cascade rules across all payment profiles for this gateway. More info about how a cascade works within a payment profile at our Knowledge Base.
Whether to enable global cascade rules for the user gateway.
Revenue rules are specific to the gateway, and allow or disallow the use of the gateway based on payment volume, occurrences and more. You can add multiple revenue rules to a gateway within the cascade. Read More
Whether revenue rules are enabled.
An array of individual revenue rules.
Whether the specific revenue rule is enabled.
The rule bounds to declare if a rule passes or fails.
- min: The final calculation value must be greater than the Rule Value.
- max: The final calculation value must be less than the Rule Value.
The rule value is compared with the calculation value and bound.
The source, in combination with the source value and calculation, is what is used to form the calculation value.
- gateway: Transactions only from the specific gateway the rule is within.
- global: All transactions regardless of gateway.
- step: The active step being processed during the payment flow.
The source value is specific to the source selected.
- captured: Only transactions which were captured.
- declined: Only transactions which were declined.
- chargeback: Only transactions which were marked as charged back.
- total: All transactions regardless of outcome or status.
- amount: Applicable only when source is 'Active Step'. The amount for the active step being processed during the payment flow.
The calculation to perform based on the source value.
- count: The total number of source value items.
- percent: The percentage of source value items.
- sum: The sum of all source value items.
The total amount of time the rule applies in a past time range.
The time unit. Used in conjunction with the time value.
- hour: Time value as hours.
- day: Time value as days.
- week: Time value as weeks.
- month: Time value as months.
Time rules are specific to the gateway, and allow or disallow the use of the gateway based on time settings. All time rules are GMT (UTC+0). Read More
Whether time rules are enabled.
An array of individual time rules.
Whether the specific time rule is enabled.
The start time, formatted as hh:mm:a
The end time, formatted as hh:mm:a
The specific weekday that the time rule applies.
- monday
- tuesday
- wednesday
- thursday
- friday
- saturday
- sunday
Whether to allow or deny the gateway from processing the step transaction based on the current GMT time and the rule day and time ranges.
- allow: Allow the gateway to process the step transaction if current GMT time and day are within the day and time ranges.
- deny: Do not allow the gateway to process the step transaction if current GMT time and day are within the day and time ranges.
The fields required for the user gateway based on the id of the site gateway fields.
The id for the individual field according to the site gateway fields required.
The value for the individual field according to the site gateway fields required.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The unix timestamp of when the item was created.
Whether the item is enabled or disabled.
The name of the item.
The description of the item.
Whether the item is enabled or disabled.
The RevCent ID of the object item.
The name of the item.
Whether the item is enabled or disabled.
Whether the item is enabled or disabled.
Whether the item is enabled or disabled.
The name of the item.
Whether the item is enabled or disabled.
Whether the item is enabled or disabled.
The RevCent ID of the object item.
The merchant account ID associated with the merchant gateway.
The name of the item.
The API request method.
The API request type.
The a brief description of the result of the API call.
The RevCent ID of the object item.
The name of the item.
The unix timestamp of when the item was updated.
Request JSON
{ "request": { "type": "user_gateway", "method": "edit", "name": "Authorize.net", "user_gateway_id": "LYE26MW8Rlh5VbJmlp2l", "description": "My awesome gateway.", "enabled": true, "merchant_account_id": "845678", "transaction_success_fee": 0.55, "transaction_fail_fee": 0.65, "discount_rate": 2.71, "site_gateway_id": "dXAmybdWwYHrLyWRAAZV", "custom_descriptor": { "enabled": true, "name": "Acme Org", "email": "email@acme.org", "url": "https://www.acme.org", "phone": "867-5399", "address": "1600 Pennsylvania Ave", "city": "Washington", "state": "DC", "postal_code": "20500" }, "global_cascade_rules": { "enabled": true, "revenue_rules": { "enabled": true, "options": [ { "enabled": true, "bound": "max", "rule_value": 5, "calculation": "count", "source": "gateway", "source_value": "chargeback", "time_value": 1, "time_unit": "month" } ] }, "time_rules": { "enabled": true, "options": [ { "start_time": "12:00am", "end_time": "11:59pm", "name": "sunday", "option": "deny", "enabled": true } ] } }, "fields": [ { "id": "1", "value": "ABCD123" }, { "id": "2", "value": "456efG789" } ] } }
Response JSON
{ "api_call_date": "2023-02-15T15:38:07+00:00", "api_call_id": "qZ90JMnBEBSOzznaldPj", "api_call_processed": true, "api_call_unix": 1676475487, "code": 1, "created_date": "2017-11-10T13:29:38+00:00", "created_date_unix": 1510320578, "custom_descriptor": { "enabled": true, "name": "Acme Org", "email": "email@acme.org", "url": "https://www.acme.org", "phone": "867-5399", "address": "1600 Pennsylvania Ave", "city": "Washington", "state": "DC", "postal_code": "20500" }, "description": "Auth.net", "discount_rate": 2.5, "enabled": true, "gateway_group": [ { "id": "GOGaPRql9oUAAkrm5Ll9", "name": "New Group" } ], "global_cascade_rules": { "revenue_rules": { "enabled": true, "options": [ { "enabled": true, "bound": "max", "rule_value": 5, "calculation": "count", "source": "gateway", "source_value": "chargeback", "time_unit": "month", "time_value": 1 } ] }, "time_rules": { "enabled": true, "options": [ { "start_time": "12:00am", "end_time": "11:59pm", "name": "sunday", "option": "deny", "enabled": true } ] }, "enabled": true }, "id": "LYE26MW8Rlh5VbJmlp2l", "merchant_account_id": "845678", "name": "Authorize.net", "request_method": "edit", "request_type": "user_gateway", "result": "Gateway edited.", "site_gateway": { "id": "dXAmybdWwYHrLyWRAAZV", "name": "Authorize.net" }, "transaction_fail_fee": 0.15, "transaction_success_fee": 0.25, "updated_date": "2023-02-15T15:38:07+00:00", "updated_date_unix": 1676475487 }
User Gateway Retrieve
Retrieve current information on a single user gateway or multiple user gateways.
Please view Pagination and Filters for details on retrieving multiple items.
Request JSON Schema
The main request object.
The type of request being made.
The method for the request type.
The RevCent ID of the item. Required if multiple property equals false or is not present.
Whether it is a multiple type request.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The number of result items contained in the current page.
The current page of result, same as requested page, default is page 1.
The API request method.
The API request type.
An array of objects, each object being a unique item.
The unix timestamp of when the item was created.
Whether the item is enabled or disabled.
The name of the item.
The description of the item.
Whether the item is enabled or disabled.
The RevCent ID of the object item.
The name of the item.
Whether the item is enabled or disabled.
Whether the item is enabled or disabled.
Whether the item is enabled or disabled.
The name of the item.
Whether the item is enabled or disabled.
Whether the item is enabled or disabled.
The RevCent ID of the object item.
The merchant account ID associated with the merchant gateway.
The name of the item.
The RevCent ID of the object item.
The name of the item.
The unix timestamp of when the item was updated.
The total number of result items for the given request.
The total number of pages for the given request.
Request JSON
{ "request": { "type": "user_gateway", "method": "retrieve", "id": "LYE26MW8Rlh5VbJmlp2l", "multiple": false, "filters": { "limit": 100, "page": 1, "status_filter": [ "enabled" ] } } }
Response JSON
{ "api_call_id": "8ry1nRVXMaHvjrlKrKvl", "api_call_processed": true, "api_call_unix": 1676475737, "code": 1, "current_count": 1, "current_page": 1, "request_method": "retrieve", "request_type": "user_gateway", "results": [ { "created_date_unix": 1510320578, "custom_descriptor": { "enabled": true, "name": "Acme Org", "email": "email@acme.org", "url": "https://www.acme.org", "phone": "867-5399", "address": "1600 Pennsylvania Ave", "city": "Washington", "state": "DC", "postal_code": "20500" }, "description": "Auth.net", "discount_rate": 2.5, "enabled": true, "gateway_group": [ { "id": "GOGaPRql9oUAAkrm5Ll9", "name": "New Group" } ], "global_cascade_rules": { "revenue_rules": { "enabled": true, "options": [ { "enabled": true, "bound": "max", "rule_value": 5, "calculation": "count", "source": "gateway", "source_value": "chargeback", "time_unit": "month", "time_value": 1 } ] }, "time_rules": { "enabled": true, "options": [ { "start_time": "12:00am", "end_time": "11:59pm", "name": "sunday", "option": "deny", "enabled": true } ] }, "enabled": true }, "id": "LYE26MW8Rlh5VbJmlp2l", "merchant_account_id": "845678", "name": "Authorize.net", "site_gateway": { "id": "dXAmybdWwYHrLyWRAAZV", "name": "Authorize.net" }, "transaction_fail_fee": 0, "transaction_success_fee": 0, "updated_date_unix": 1676475487 } ], "total_count": 1, "total_pages": 1 }
Gateway Group
A gateway group is a group of gateways that can be used within a payment profile cascade. You can then add or remove a user gateway(s) from gateway groups as needed, without needing to modify the payment profile. Read more about Gateway Groups .
Gateway Group Create
Create a gateway group within RevCent via the gateway group create method.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The name of the item.
The description of the item.
Whether the item is enabled or disabled.
The method in which the gateway group will select an individual gateway.
An array of user gateway IDs to have in the gateway group.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The unix timestamp of when the item was created.
The description of the item.
Whether the item is enabled or disabled.
The RevCent ID of the object item.
The name of the item.
The API request method.
The API request type.
The a brief description of the result of the API call.
The unix timestamp of when the item was updated.
The RevCent ID of the object item.
The name of the item.
Whether the item is enabled or disabled.
Request JSON
{ "request": { "type": "gateway_group", "method": "create", "name": "New Group", "description": "Group description.", "choice_method": "evenly_distribute", "enabled": true, "user_gateway": [ "LYE26MW8Rlh5VbJmlp2l", "8rNnkY45R4Hw1ZBg1yYB" ] } }
Response JSON
{ "api_call_date": "2023-02-15T15:31:56+00:00", "api_call_id": "ajzVv1LMXPc0l6pQ4wLv", "api_call_processed": true, "api_call_unix": 1676475116, "code": 1, "created_date_unix": 1676475116, "description": "Group description", "enabled": true, "id": "2r1kMjvz2YC6bWGdjOYB", "name": "New Group", "request_method": "create", "request_type": "gateway_group", "result": "Gateway group created.", "updated_date_unix": 1676475116, "user_gateway": [ { "id": "LYE26MW8Rlh5VbJmlp2l", "name": "Authorize.net", "enabled": true }, { "id": "8rNnkY45R4Hw1ZBg1yYB", "name": "NMI", "enabled": true } ] }
Gateway Group Edit
Edit an existing gateway group within RevCent via the gateway group edit method.
Note: Only provide the properties you wish to modify. Properties not provided will remain unchanged.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The gateway group ID
The name of the item.
The description of the item.
Whether the item is enabled or disabled.
The method in which the gateway group will select an individual gateway.
An array of user gateway IDs to have in the gateway group. Important: This array will replace the gateways within a gateway group. Use the add_user_gateway or remove_user_gateway methods for adding or removing specific gateway(s) within a group while leaving the remaining user gateways.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The unix timestamp of when the item was created.
The description of the item.
Whether the item is enabled or disabled.
The RevCent ID of the object item.
The name of the item.
The API request method.
The API request type.
The a brief description of the result of the API call.
The unix timestamp of when the item was updated.
The RevCent ID of the object item.
The name of the item.
Whether the item is enabled or disabled.
Request JSON
{ "request": { "type": "gateway_group", "method": "edit", "gateway_group_id": "GOGaPRql9oUAAkrm5Ll9", "name": "New Group", "description": "Group description.", "choice_method": "round_robin", "enabled": true, "user_gateway": [ "8rNnkY45R4Hw1ZBg1yYB" ] } }
Response JSON
{ "api_call_date": "2023-02-15T15:31:56+00:00", "api_call_id": "ajzVv1LMXPc0l6pQ4wLv", "api_call_processed": true, "api_call_unix": 1676475116, "code": 1, "created_date_unix": 1676475116, "description": "Group description", "enabled": true, "id": "2r1kMjvz2YC6bWGdjOYB", "name": "New Group 2", "request_method": "edit", "request_type": "gateway_group", "result": "Gateway group edited.", "updated_date_unix": 1676475116, "user_gateway": [ { "id": "8rNnkY45R4Hw1ZBg1yYB", "name": "NMI", "enabled": true } ] }
Gateway Group Add User Gateway
Add a user gateway to a gateway group. Use this method to add a user gateway(s) without modifying existing user gateways in the gateway group.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The gateway group ID
An array of user gateway IDs to add to the gateway group.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The unix timestamp of when the item was created.
The description of the item.
Whether the item is enabled or disabled.
The RevCent ID of the object item.
The name of the item.
The API request method.
The API request type.
The a brief description of the result of the API call.
The unix timestamp of when the item was updated.
The RevCent ID of the object item.
The name of the item.
Whether the item is enabled or disabled.
Request JSON
{ "request": { "type": "gateway_group", "method": "add_user_gateway", "gateway_group_id": "GOGaPRql9oUAAkrm5Ll9", "user_gateway": [ "GOJankNpkpsPzw6No1OP" ] } }
Response JSON
{ "api_call_date": "2023-02-15T02:51:25+00:00", "api_call_id": "ZVAlyYEgnOSR2wEYZbZg", "api_call_processed": true, "api_call_unix": 1676429485, "code": 1, "created_date_unix": 1675884443, "description": "", "enabled": true, "id": "GOGaPRql9oUAAkrm5Ll9", "name": "New Group", "request_method": "add_user_gateway", "request_type": "gateway_group", "result": "Gateway added to group.", "updated_date_unix": 1676429485, "user_gateway": [ { "id": "GOJankNpkpsPzw6No1OP", "name": "Stripe", "enabled": true }, { "id": "8rNnkY45R4Hw1ZBg1yYB", "name": "NMI", "enabled": true } ] }
Gateway Group Remove User Gateway
Remove a user gateway to a gateway group. Use this method to remove a user gateway(s) without modifying existing user gateways in the gateway group.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The gateway group ID
An array of user gateway IDs to remove from the gateway group.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The unix timestamp of when the item was created.
The description of the item.
Whether the item is enabled or disabled.
The RevCent ID of the object item.
The name of the item.
The API request method.
The API request type.
The a brief description of the result of the API call.
The unix timestamp of when the item was updated.
The RevCent ID of the object item.
The name of the item.
Whether the item is enabled or disabled.
Request JSON
{ "request": { "type": "gateway_group", "method": "remove_user_gateway", "gateway_group_id": "GOGaPRql9oUAAkrm5Ll9", "user_gateway": [ "GOJankNpkpsPzw6No1OP" ] } }
Response JSON
{ "api_call_date": "2023-02-15T02:51:01+00:00", "api_call_id": "Q4kdYEAqPkt8lO14XNXL", "api_call_processed": true, "api_call_unix": 1676429461, "code": 1, "created_date_unix": 1675884443, "description": "", "enabled": true, "id": "GOGaPRql9oUAAkrm5Ll9", "name": "New Group", "request_method": "remove_user_gateway", "request_type": "gateway_group", "result": "Gateway removed from group.", "updated_date_unix": 1676429461, "user_gateway": [ { "id": "8rNnkY45R4Hw1ZBg1yYB", "name": "NMI", "enabled": true } ] }
Gateway Group Retrieve
Retrieve current information on a single gateway group or multiple gateway groups.
Please view Pagination and Filters for details on retrieving multiple items.
Request JSON Schema
The main request object.
The type of request being made.
The method for the request type.
The RevCent ID of the item. Required if multiple property equals false or is not present.
Whether it is a multiple type request.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The number of result items contained in the current page.
The current page of result, same as requested page, default is page 1.
The API request method.
The API request type.
An array of objects, each object being a unique item.
The unix timestamp of when the item was created.
The description of the item.
Whether the item is enabled or disabled.
The RevCent ID of the object item.
The name of the item.
The unix timestamp of when the item was updated.
The RevCent ID of the object item.
The name of the item.
Whether the item is enabled or disabled.
The total number of result items for the given request.
The total number of pages for the given request.
Request JSON
{ "request": { "type": "gateway_group", "method": "retrieve", "id": "GOGaPRql9oUAAkrm5Ll9", "multiple": false, "filters": { "limit": 100, "page": 1, "status_filter": [ "enabled" ] } } }
Response JSON
{ "api_call_id": "JNOdrkg91lh4LWlZWAVv", "api_call_processed": true, "api_call_unix": 1676476618, "code": 1, "current_count": 1, "current_page": 1, "request_method": "retrieve", "request_type": "gateway_group", "results": [ { "created_date_unix": 1675884443, "description": "", "enabled": true, "id": "GOGaPRql9oUAAkrm5Ll9", "name": "New Group", "updated_date_unix": 1676429485, "user_gateway": [ { "id": "8rNnkY45R4Hw1ZBg1yYB", "name": "NMI", "enabled": true } ] } ], "total_count": 1, "total_pages": 1 }
Payment Profile
A payment profile allows payments to flow through your processors based on specific rules, as well as process lost revenue from fully declined or partially declined payments. Read more about Payment Profiles .
Payment Profile Create
Create a payment profile within RevCent via the payment profile create method.
Important: Payment profiles are a powerful feature, with settings and orders that require detailed precision. A misconfigured payment profile can prevent payments from processing entirely. Please read more about Payment Profiles before proceeding.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The name of the item.
The description of the item.
Whether the item is enabled or disabled.
The steps for the payment flow. The payment flow is the core part of a payment profile and dictates what processor to use for a payment and what to do if a payment is declined. The payment flow consists of steps, each step being a payment attempt. Read More
The options to take if the step transaction is declined.
The value in which to modify according to declined_modify.
- nothing: Do nothing simply ends the payment profile process at the step. The transaction is returned as declined.
- nomodify: Don't Modify Amount allows you to simply proceed to another step. For example, if you wish to try another gateway without modifying the initial amount, you would choose this.
- modifypct: Modify the original transaction amount by a percentage decrease.
- modifyspf: Modify the original transaction amount by a fixed dollar amount decrease.
- next: If you wish to proceed to the next step in the flow.
- repeat: If you wish to repeat to the current step one more time.
- nothing: If you wish to end the payment flow.
The order of the step within the array of steps.
- gateway: Process step transaction using a specific gateway.
- cascade: Process step transaction using the cascade.
- sort_order: Process valid gateways in the sort order within the cascade, beginning with gateway 1 in the cascade. I.e. if gateway 1 is valid, then it will be used, else gateway 2 if valid, and so on.
- round_robin: Process cascade gateways in the sort order within the cascade, beginning with the next gateway after the last transaction gateway used in the cascade sort order. I.e. if gateway 1 was last used, then gateway 2 will be used if valid. If gateway 3 is last used, and is the last gateway in the rotation, then the rotation resets and gateway 1 will be used if valid.
- evenly_distribute: Process valid gateways by even distribution of total captured payment volume within the past 24 hours. Sort order in the cascade is ignored. Instead, least captured payment volume is what determines which gateway will be used. I.e. If gateway X has total captured payment volume of $210, gateway Y has total captured payment volume of $200 and gateway Z has total captured payment volume of $230, then gateway Y will be used as it has the least total captured payment volume.
The ID of the gateway, if source is gateway.
Whether to try a different card if a preceeding step is declined.
A payment profile cascade allows you to process transactions at specific gateways using a specific order and set rules for each gateway. Read More
The source of items for the cascade.
- gateways: Use the list of gateway(s) as the cascade source.
- gateway_groups: Use the list of gateway group(s) as the cascade source.
A list of one or more gateways to use as the source within the cascade. Read More
Revenue rules are specific to the gateway, and allow or disallow the use of the gateway based on payment volume, occurrences and more. You can add multiple revenue rules to a gateway within the cascade. Read More
Whether revenue rules are enabled.
An array of individual revenue rules.
Whether the specific revenue rule is enabled.
The rule bounds to declare if a rule passes or fails.
- min: The final calculation value must be greater than the Rule Value.
- max: The final calculation value must be less than the Rule Value.
The rule value is compared with the calculation value and bound.
The source, in combination with the source value and calculation, is what is used to form the calculation value.
- gateway: Transactions only from the specific gateway the rule is within.
- global: All transactions regardless of gateway.
- step: The active step being processed during the payment flow.
The source value is specific to the source selected.
- captured: Only transactions which were captured.
- declined: Only transactions which were declined.
- chargeback: Only transactions which were marked as charged back.
- total: All transactions regardless of outcome or status.
- amount: Applicable only when source is 'Active Step'. The amount for the active step being processed during the payment flow.
The calculation to perform based on the source value.
- count: The total number of source value items.
- percent: The percentage of source value items.
- sum: The sum of all source value items.
The total amount of time the rule applies in a past time range.
The time unit. Used in conjunction with the time value.
- hour: Time value as hours.
- day: Time value as days.
- week: Time value as weeks.
- month: Time value as months.
Time rules are specific to the gateway, and allow or disallow the use of the gateway based on time settings. All time rules are GMT (UTC+0). Read More
Whether time rules are enabled.
An array of individual time rules.
Whether the specific time rule is enabled.
The start time, formatted as hh:mm:a
The end time, formatted as hh:mm:a
The specific weekday that the time rule applies.
- monday
- tuesday
- wednesday
- thursday
- friday
- saturday
- sunday
Whether to allow or deny the gateway from processing the step transaction based on the current GMT time and the rule day and time ranges.
- allow: Allow the gateway to process the step transaction if current GMT time and day are within the day and time ranges.
- deny: Do not allow the gateway to process the step transaction if current GMT time and day are within the day and time ranges.
Whether the gateway is enabled within the cascade.
The order in which the gateway resides in the cascade.
The ID of the gateway.
A list of one or more gateway groups to use as the source within the cascade. Read More
Whether the gateway group is enabled within the cascade.
The order in which the gateway group resides in the cascade.
The ID of the gateway group.
You have the ability to cancel the payment profile flow if a declined transaction has specific terms/phrases/words in a step gateways' decline response. Read More
Whether to enable kill terms.
An array of one or more kill terms. Kill terms are case-insensitive. This will also cancel/void the related sale being attempted. Only applies to initial sale attempts, not renewals or trial expirations.
You have the ability to cancel/void a sale if the number of declined payment profile attempts reaches a certain number. Read More
Whether to enable max attempts.
The number of failed payment profile attempts, where once reached, the sale being processed will automatically be cancelled/voided.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
Whether the item is enabled or disabled.
The RevCent ID of the object item.
Whether the item is enabled or disabled.
Whether the item is enabled or disabled.
Whether the item is enabled or disabled.
The name of the item.
Whether the item is enabled or disabled.
The name of the item.
Whether the item is enabled or disabled.
The RevCent ID of the object item.
The name of the item.
The result code for the request.
0 = RevCent Error
1 = Success
The unix timestamp of when the item was created.
The description of the item.
Whether the item is enabled or disabled.
The RevCent ID of the object item.
Whether the item is enabled or disabled.
Whether the item is enabled or disabled.
The name of the item.
The API request method.
The API request type.
The a brief description of the result of the API call.
Gateway related to the item.
The unix timestamp of when the item was updated.
Request JSON
{ "request": { "type": "payment_profile", "method": "create", "name": "My Payment Profile", "description": "", "enabled": true, "steps": [ { "declined_options": { "declined_setting": "modifypct", "declined_modify": "10", "declined_action": "next" }, "order": 1, "source": "cascade", "cascade_order": "round_robin", "gateway": "LYE26MW8Rlh5VbJmlp2l", "swap_card": false }, { "declined_options": { "declined_setting": "nothing", "declined_modify": "0", "declined_action": "nothing" }, "order": 2, "source": "gateway", "cascade_order": "round_robin", "gateway": "8rNnkY45R4Hw1ZBg1yYB", "swap_card": true } ], "cascade": { "cascade_source": "gateway_groups", "gateways": [ { "revenue_rules": { "enabled": true, "options": [ { "enabled": true, "bound": "max", "rule_value": 5, "calculation": "count", "source": "gateway", "source_value": "chargeback", "time_value": 1, "time_unit": "month" } ] }, "time_rules": { "enabled": true, "options": [ { "start_time": "12:00am", "end_time": "11:59pm", "name": "sunday", "option": "deny", "enabled": true } ] }, "enabled": true, "order": 1, "id": "LYE26MW8Rlh5VbJmlp2l" } ], "gateway_groups": [ { "enabled": false, "order": 1, "id": "GOGaPRql9oUAAkrm5Ll9" } ] }, "kill_terms": { "enabled": true, "terms": [ "NSF" ] }, "max_attempts": { "enabled": true, "num": 1 } } }
Response JSON
{ "api_call_date": "2023-02-17T20:01:46+00:00", "api_call_id": "zGJbyZPNQkILyN9Z6L4a", "api_call_processed": true, "api_call_unix": 1676664106, "cascade": { "cascade_source": "gateway_groups", "gateways": [ { "enabled": true, "order": 1, "id": "LYE26MW8Rlh5VbJmlp2l", "global_cascade_rules_enabled": true, "revenue_rules": { "enabled": true, "options": [ { "enabled": true, "bound": "max", "rule_value": 5, "calculation": "count", "source": "gateway", "source_value": "chargeback", "time_unit": "month", "time_value": 1 } ] }, "time_rules": { "enabled": true, "options": [ { "start_time": "12:00am", "end_time": "11:59pm", "name": "sunday", "option": "deny", "enabled": true } ] }, "name": "Authorize.net" } ], "gateway_groups": [ { "enabled": false, "order": 1, "id": "GOGaPRql9oUAAkrm5Ll9", "name": "New Group" } ] }, "code": 1, "created_date": "2023-02-17T20:01:46+00:00", "created_date_unix": 1676664106, "description": "", "enabled": true, "id": "RJ0YXwdGzbFpXO9ENpqw", "kill_terms": { "enabled": true, "terms": [ "NSF" ] }, "max_attempts": { "enabled": true, "num": 1 }, "name": "My Payment Profile", "request_method": "create", "request_type": "payment_profile", "result": "Payment profile created.", "steps": [ { "declined_options": { "declined_action": "next", "declined_modify": "10", "declined_setting": "modifypct" }, "cascade_order": "round_robin", "source": "cascade", "gateway": null, "swap_card": false, "order": 1 }, { "declined_options": { "declined_action": "nothing", "declined_modify": "0", "declined_setting": "nothing" }, "cascade_order": "round_robin", "source": "gateway", "gateway": "8rNnkY45R4Hw1ZBg1yYB", "swap_card": true, "order": 2 } ], "updated_date": "2023-02-17T20:01:46+00:00", "updated_date_unix": 1676664106 }
Payment Profile Edit
Edit an existing payment profile within RevCent via the payment profile edit method.
Note: Only provide the properties you wish to modify. Properties not provided will remain unchanged.
Important: Payment profiles are a powerful feature, with settings and orders that require detailed precision. A misconfigured payment profile can prevent payments from processing entirely. Please read more about Payment Profiles before proceeding.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The ID of the payment profile you are modifying.
The name of the item.
The description of the item.
Whether the item is enabled or disabled.
The steps for the payment flow. The payment flow is the core part of a payment profile and dictates what processor to use for a payment and what to do if a payment is declined. The payment flow consists of steps, each step being a payment attempt. Read More
The options to take if the step transaction is declined.
The value in which to modify according to declined_modify.
- nothing: Do nothing simply ends the payment profile process at the step. The transaction is returned as declined.
- nomodify: Don't Modify Amount allows you to simply proceed to another step. For example, if you wish to try another gateway without modifying the initial amount, you would choose this.
- modifypct: Modify the original transaction amount by a percentage decrease.
- modifyspf: Modify the original transaction amount by a fixed dollar amount decrease.
- next: If you wish to proceed to the next step in the flow.
- repeat: If you wish to repeat to the current step one more time.
- nothing: If you wish to end the payment flow.
The order of the step within the array of steps.
- gateway: Process step transaction using a specific gateway.
- cascade: Process step transaction using the cascade.
- sort_order: Process valid gateways in the sort order within the cascade, beginning with gateway 1 in the cascade. I.e. if gateway 1 is valid, then it will be used, else gateway 2 if valid, and so on.
- round_robin: Process cascade gateways in the sort order within the cascade, beginning with the next gateway after the last transaction gateway used in the cascade sort order. I.e. if gateway 1 was last used, then gateway 2 will be used if valid. If gateway 3 is last used, and is the last gateway in the rotation, then the rotation resets and gateway 1 will be used if valid.
- evenly_distribute: Process valid gateways by even distribution of total captured payment volume within the past 24 hours. Sort order in the cascade is ignored. Instead, least captured payment volume is what determines which gateway will be used. I.e. If gateway X has total captured payment volume of $210, gateway Y has total captured payment volume of $200 and gateway Z has total captured payment volume of $230, then gateway Y will be used as it has the least total captured payment volume.
The ID of the gateway, if source is gateway.
Whether to try a different card if a preceeding step is declined.
A payment profile cascade allows you to process transactions at specific gateways using a specific order and set rules for each gateway. Read More
The source of items for the cascade.
- gateways: Use the list of gateway(s) as the cascade source.
- gateway_groups: Use the list of gateway group(s) as the cascade source.
A list of one or more gateways to use as the source within the cascade. Read More
Revenue rules are specific to the gateway, and allow or disallow the use of the gateway based on payment volume, occurrences and more. You can add multiple revenue rules to a gateway within the cascade. Read More
Whether revenue rules are enabled.
An array of individual revenue rules.
Whether the specific revenue rule is enabled.
The rule bounds to declare if a rule passes or fails.
- min: The final calculation value must be greater than the Rule Value.
- max: The final calculation value must be less than the Rule Value.
The rule value is compared with the calculation value and bound.
The source, in combination with the source value and calculation, is what is used to form the calculation value.
- gateway: Transactions only from the specific gateway the rule is within.
- global: All transactions regardless of gateway.
- step: The active step being processed during the payment flow.
The source value is specific to the source selected.
- captured: Only transactions which were captured.
- declined: Only transactions which were declined.
- chargeback: Only transactions which were marked as charged back.
- total: All transactions regardless of outcome or status.
- amount: Applicable only when source is 'Active Step'. The amount for the active step being processed during the payment flow.
The calculation to perform based on the source value.
- count: The total number of source value items.
- percent: The percentage of source value items.
- sum: The sum of all source value items.
The total amount of time the rule applies in a past time range.
The time unit. Used in conjunction with the time value.
- hour: Time value as hours.
- day: Time value as days.
- week: Time value as weeks.
- month: Time value as months.
Time rules are specific to the gateway, and allow or disallow the use of the gateway based on time settings. All time rules are GMT (UTC+0). Read More
Whether time rules are enabled.
An array of individual time rules.
Whether the specific time rule is enabled.
The start time, formatted as hh:mm:a
The end time, formatted as hh:mm:a
The specific weekday that the time rule applies.
- monday
- tuesday
- wednesday
- thursday
- friday
- saturday
- sunday
Whether to allow or deny the gateway from processing the step transaction based on the current GMT time and the rule day and time ranges.
- allow: Allow the gateway to process the step transaction if current GMT time and day are within the day and time ranges.
- deny: Do not allow the gateway to process the step transaction if current GMT time and day are within the day and time ranges.
Whether the gateway is enabled within the cascade.
The order in which the gateway resides in the cascade.
The ID of the gateway.
A list of one or more gateway groups to use as the source within the cascade. Read More
Whether the gateway group is enabled within the cascade.
The order in which the gateway group resides in the cascade.
The ID of the gateway group.
You have the ability to cancel the payment profile flow if a declined transaction has specific terms/phrases/words in a step gateways' decline response. Read More
Whether to enable kill terms.
An array of one or more kill terms. Kill terms are case-insensitive. This will also cancel/void the related sale being attempted. Only applies to initial sale attempts, not renewals or trial expirations.
You have the ability to cancel/void a sale if the number of declined payment profile attempts reaches a certain number. Read More
Whether to enable max attempts.
The number of failed payment profile attempts, where once reached, the sale being processed will automatically be cancelled/voided.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
Whether the item is enabled or disabled.
The RevCent ID of the object item.
Whether the item is enabled or disabled.
Whether the item is enabled or disabled.
Whether the item is enabled or disabled.
The name of the item.
Whether the item is enabled or disabled.
The name of the item.
Whether the item is enabled or disabled.
The RevCent ID of the object item.
The name of the item.
The result code for the request.
0 = RevCent Error
1 = Success
The unix timestamp of when the item was created.
The description of the item.
Whether the item is enabled or disabled.
The RevCent ID of the object item.
Whether the item is enabled or disabled.
Whether the item is enabled or disabled.
The name of the item.
The API request method.
The API request type.
The a brief description of the result of the API call.
Gateway related to the item.
The unix timestamp of when the item was updated.
Request JSON
{ "request": { "type": "payment_profile", "method": "edit", "payment_profile_id": "RJ0YXwdGzbFpXO9ENpqw", "name": "My Payment Profile", "description": "", "enabled": true, "steps": [ { "declined_options": { "declined_setting": "modifypct", "declined_modify": "10", "declined_action": "next" }, "order": 1, "source": "cascade", "cascade_order": "round_robin", "gateway": "LYE26MW8Rlh5VbJmlp2l", "swap_card": false }, { "declined_options": { "declined_setting": "nothing", "declined_modify": "0", "declined_action": "nothing" }, "order": 2, "source": "gateway", "cascade_order": "round_robin", "gateway": "8rNnkY45R4Hw1ZBg1yYB", "swap_card": true } ], "cascade": { "cascade_source": "gateways", "gateways": [ { "revenue_rules": { "enabled": true, "options": [ { "enabled": true, "bound": "max", "rule_value": 5, "calculation": "count", "source": "gateway", "source_value": "chargeback", "time_value": 1, "time_unit": "month" } ] }, "time_rules": { "enabled": false, "options": [ { "start_time": "12:00am", "end_time": "11:59pm", "name": "sunday", "option": "deny", "enabled": true } ] }, "enabled": true, "order": 1, "id": "LYE26MW8Rlh5VbJmlp2l" } ], "gateway_groups": [ { "enabled": false, "order": 1, "id": "GOGaPRql9oUAAkrm5Ll9" } ] }, "kill_terms": { "enabled": true, "terms": [ "NSF" ] }, "max_attempts": { "enabled": true, "num": 1 } } }
Response JSON
{ "api_call_date": "2023-02-17T20:04:23+00:00", "api_call_id": "6rQPpKLzmnhmLOpQ5JlL", "api_call_processed": true, "api_call_unix": 1676664263, "cascade": { "cascade_source": "gateways", "gateways": [ { "enabled": true, "order": 1, "id": "LYE26MW8Rlh5VbJmlp2l", "global_cascade_rules_enabled": true, "revenue_rules": { "enabled": true, "options": [ { "enabled": true, "bound": "max", "rule_value": 5, "calculation": "count", "source": "gateway", "source_value": "chargeback", "time_unit": "month", "time_value": 1 } ] }, "time_rules": { "enabled": true, "options": [ { "start_time": "12:00am", "end_time": "11:59pm", "name": "sunday", "option": "deny", "enabled": true } ] }, "name": "Authorize.net" } ], "gateway_groups": [ { "enabled": false, "order": 1, "id": "GOGaPRql9oUAAkrm5Ll9", "name": "New Group" } ] }, "code": 1, "created_date": "2023-02-17T20:01:46+00:00", "created_date_unix": 1676664106, "description": "", "enabled": true, "id": "RJ0YXwdGzbFpXO9ENpqw", "kill_terms": { "enabled": true, "terms": [ "NSF" ] }, "max_attempts": { "enabled": true, "num": 1 }, "name": "My Payment Profile", "request_method": "edit", "request_type": "payment_profile", "result": "Payment profile edited.", "steps": [ { "declined_options": { "declined_setting": "modifypct", "declined_modify": "10", "declined_action": "next" }, "source": "cascade", "cascade_order": "round_robin", "gateway": null, "swap_card": false, "order": 1 }, { "declined_options": { "declined_setting": "nothing", "declined_modify": "0", "declined_action": "nothing" }, "source": "gateway", "cascade_order": "round_robin", "gateway": "8rNnkY45R4Hw1ZBg1yYB", "swap_card": true, "order": 2 } ], "updated_date": "2023-02-17T20:04:23+00:00", "updated_date_unix": 1676664263 }
Payment Profile Retrieve
Retrieve current information on a single payment profile or multiple payment profiles.
Please view Pagination and Filters for details on retrieving multiple items.
Request JSON Schema
The main request object.
The type of request being made.
The method for the request type.
The RevCent ID of the item. Required if multiple property equals false or is not present.
Whether it is a multiple type request.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The number of result items contained in the current page.
The current page of result, same as requested page, default is page 1.
The API request method.
The API request type.
An array of objects, each object being a unique item.
Whether the item is enabled or disabled.
The RevCent ID of the object item.
Whether the item is enabled or disabled.
Whether the item is enabled or disabled.
Whether the item is enabled or disabled.
The name of the item.
Whether the item is enabled or disabled.
The name of the item.
Whether the item is enabled or disabled.
The RevCent ID of the object item.
The name of the item.
The unix timestamp of when the item was created.
The description of the item.
Whether the item is enabled or disabled.
The RevCent ID of the object item.
Whether the item is enabled or disabled.
Whether the item is enabled or disabled.
The name of the item.
Gateway related to the item.
The unix timestamp of when the item was updated.
The total number of result items for the given request.
The total number of pages for the given request.
Request JSON
{ "request": { "type": "payment_profile", "method": "retrieve", "id": "2r1Wo7KvJ6slWE99XK5y", "multiple": false, "filters": { "limit": 100, "page": 1, "status_filter": [ "enabled" ] } } }
Response JSON
{ "api_call_id": "ZVA1wj2YoRCqY0a8Mz8m", "api_call_processed": true, "api_call_unix": 1676663664, "code": 1, "current_count": 1, "current_page": 1, "request_method": "retrieve", "request_type": "payment_profile", "results": [ { "cascade": { "cascade_source": "gateways", "gateways": [ { "enabled": true, "order": 1, "id": "LYE26MW8Rlh5VbJmlp2l", "global_cascade_rules_enabled": true, "revenue_rules": { "enabled": true, "options": [ { "enabled": true, "bound": "max", "rule_value": 5, "calculation": "count", "source": "gateway", "source_value": "chargeback", "time_unit": "month", "time_value": 1 } ] }, "time_rules": { "enabled": true, "options": [ { "start_time": "12:00am", "end_time": "11:59pm", "name": "sunday", "option": "deny", "enabled": true } ] }, "name": "Authorize.net" } ], "gateway_groups": [ { "enabled": false, "order": 1, "id": "GOGaPRql9oUAAkrm5Ll9", "name": "My Gatewway Group" } ] }, "created_date_unix": 1676657587, "description": "", "enabled": false, "id": "2r1Wo7KvJ6slWE99XK5y", "kill_terms": { "enabled": true, "terms": [ "pick up card" ] }, "max_attempts": { "enabled": true, "num": 2 }, "name": "My Payment Profile", "steps": [ { "declined_options": { "declined_setting": "modifypct", "declined_modify": "15", "declined_action": "next" }, "source": "cascade", "cascade_order": "evenly_distribute", "gateway": null, "swap_card": false, "order": 1 }, { "declined_options": { "declined_setting": "nothing", "declined_modify": "0", "declined_action": "nothing" }, "source": "gateway", "cascade_order": "round_robin", "gateway": "8rNnkY45R4Hw1ZBg1yYB", "swap_card": true, "order": 2 } ], "updated_date_unix": 1676661655 } ], "total_count": 1, "total_pages": 1 }
Invoice
An Invoice is a pending sale with an option to pay online. The only difference between an invoice and a vanilla pending sale is the Hosted Page integration, allowing the customer to pay the amount due online at via a customizable web page.
Invoice Create
Create an invoice via the invoice create method. All fields that are available in a regular Sale Create API call, with the exception of the payment object, are also available i.e. discounts, shipping, etc.
AdWords Integration
If you wish to associate the item with a specific AdWords click ID include an "adwords_click" object in your request metadata array. RevCent will detect the specific metadata object with name="adwords_click" and pull data on the AdWords click ID. Read more about integrating AdWords with RevCent on our Knowledge Base .
Example
"metadata":[{"name": "adwords_click", "value": "ADWORDS_CLICK_ID_HERE"}]
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The invoice type. Always set to "sale_create".
The invoice profile ID to associate with the invoice being created. This determines the hosted page markup and URL.
The campaign to associate with the request. This can be either the RevCent ID of the campaign or the RevCent name of the campaign.
ISO 4217 currency code. If not provided default is 'USD'.
The product array contains individual product objects.
Pricing is automatically calculated based upon the quantity, price or both if present.
The ID for the product, this can be the RevCent ID, SKU, internal_id, product name or additional_id values.
The price, if different from the product default price, you wish to charge.
The quantity. Default is 1.
Create a trial for the specific product being sold ending on a specific date. Also useful for starting a subscription on a specific date. Format must be MM/DD/YYYY.
Create a trial for the specific product being sold ending after the number of days provided.
The customer object receives first priority as details if creating a new customer.
If the customer object is not present the bill_to and ship_to objects will be used in the respective order.
If neither customer, bill_to or ship_to objects are provided the new customer will be created as 'Anonymous'.
This does not apply if using a customer_id field in the request where applicable.
Response JSON Schema
The current total amount after any refunds, cancellations or other changes. Equals amount_original_total - (amount_void + amount_refunded).
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The RevCent ID of the campaign.
The name of the campaign associated with the item.
The result code for the request.
0 = RevCent Error
1 = Success
The customer object.
The customers' first address line.
The customers' second address line.
Whether the customer has been blocked from purchases.
The customers' city.
The customers' company.
The customers' country.
The customers' email.
Whether the customer is currently enabled.
The customers' first name.
The customers' full address.
Whether the customers' address was successfully geocoded using the Google geocoding service.
The Google place ID for the customers' address using the Google geocoding service.
The RevCent ID for the customer.
Your internal ID for the customer.
The customers' last name.
The approximate latitude for the customers' address using the Google geocoding service.
The approximate longitude for the customers' address using the Google geocoding service.
The customers' phone number.
The customers' state.
The customers' state in long format.
The customers' status.
The customers' zip or postal code.
The RevCent ID of the customer.
The Hosted Page URL for online payment.
The newly created invoice ID.
The RevCent ID of the object item.
The name of the item.
ISO 4217 currency code.
The metadata array containing name:value objects.
The name property for the metadata object.
The value property for the metadata object.
The API request method.
The API request type.
The a brief description of the result of the API call.
The sale ID for the invoice.
The current status of the related item.
Request JSON
{ "request": { "type": "invoice", "method": "create", "invoice_type": "sale_create", "invoice_profile": "gYo0YVd24Qf7QvdBYM2O", "iso_currency": "USD", "product": [ { "id": "av_2017", "price": 19.99, "quantity": 2 } ], "campaign": "Adwords Campaign", "customer": { "first_name": "vqjh", "last_name": "slszhjru", "address_line_1": "1600 Pennsylvania Ave", "address_line_2": "", "city": "Washington", "state": "DC", "zip": "20500", "country": "USA", "company": "", "email": "ctnb@gmail.com", "phone": "1234567890" }, "metadata": [ { "name": "invoice_create", "value": "test" } ] } }
Response JSON
{ "amount_total": 176.79, "api_call": { "id": "ZVRV87lEoLuKWJY5gg8z" }, "api_call_id": "ZVRV87lEoLuKWJY5gg8z", "api_call_processed": true, "api_call_unix": 1602980700, "campaign_id": "mJ1zZoOobEuP8pnWKXd1", "campaign_name": "Adwords Campaign", "code": 1, "customer": { "address_line_1": "1600 Pennsylvania Ave", "address_line_2": "", "blocked": false, "city": "Washington", "company": "", "country": "USA", "email": "georgew@whitehouse.com", "enabled": true, "first_name": "George", "full_address": "1600 Pennsylvania Ave NW, Washington, DC 20500, USA", "geocode_success": true, "google_place_id": "ChIJGVtI4by3t4kRr51d_Qm_x58", "id": "4r158EzJmmcVM69dNLkg", "internal_id": "pres_0001", "last_name": "Washington", "lat": "38.8976633", "lon": "-77.0365739", "metadata": [], "phone": "1234567890", "state": "DC", "state_long": "DC", "zip": "20500" }, "customer_id": "8rQrl21wjYcvJkzLaad8", "hosted_url": "https://securehost.revcent.com/MyCompanyName/invoice?invoice_id=ajqjGdVO9Bi1Ly2nkkW7", "invoice_id": "ajqjGdVO9Bi1Ly2nkkW7", "invoice_profile": { "id": "gYo0YVd24Qf7QvdBYM2O", "name": "tqawqtq" }, "iso_currency": "USD", "metadata": [ { "entry_date": "2020-10-18", "name": "invoice_create", "value": "test" } ], "request_method": "create", "request_type": "invoice", "result": "Invoice created.", "sale_id": "mJqJ6mnGbrUwmG0q22V9", "status": "Unpaid" }
Invoice Retrieve
Retrieve current information on a single invoice or multiple invoices.
Please view Pagination and Filters for details on retrieving multiple items.
The response may include AdWords Response Objects within each item if an AdWords click ID is associated with the item.
Request JSON Schema
The main request object.
The type of request being made.
The method for the request type.
The RevCent ID of the item. Required if multiple property equals false or is not present.
Whether it is a multiple type request.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The number of result items contained in the current page.
The current page of result, same as requested page, default is page 1.
The API request method.
The API request type.
An array of objects, each object being a unique item.
The total calculated amount when an item is created.
The current total amount after any refunds, cancellations or other changes. Equals amount_original_total - (amount_void + amount_refunded).
The RevCent ID of the campaign.
The name of the campaign associated with the item.
An array containing check direct IDs related to the item.
The unix timestamp of when the item was created.
The customer object.
The customers' first address line.
The customers' second address line.
Whether the customer has been blocked from purchases.
The customers' city.
The customers' company.
The customers' country.
The customers' email.
Whether the customer is currently enabled.
The customers' first name.
The customers' full address.
Whether the customers' address was successfully geocoded using the Google geocoding service.
The Google place ID for the customers' address using the Google geocoding service.
The RevCent ID for the customer.
Your internal ID for the customer.
The customers' last name.
The approximate latitude for the customers' address using the Google geocoding service.
The approximate longitude for the customers' address using the Google geocoding service.
The customers' phone number.
The customers' state.
The customers' state in long format.
The customers' status.
The customers' zip or postal code.
An array containing discounts related to the item.
The RevCent ID of the object item.
The RevCent ID of the object item.
The name of the item.
ISO 4217 currency code.
An array of RevCent license key ID's associated with the item.
An array containing offline payment IDs related to the item.
The payment type related to the item.
The system ID of the payment type related to the item.
The system name of the payment type related to the item.
An array containing RevCent PayPal transaction IDs related to the item.
An array containing pending refund IDs related to the item.
An array containing product sale IDs related to the item.
An array containing quota account IDs related to the item.
The RevCent hosted shopping cart that item originated from.
An array containing sale IDs related to the item.
An array containing salvage transaction IDs related to the item.
An array containing shipping IDs related to the item.
An array containing SMTP message IDs related to the item.
The current status of the related item.
An array containing subscription renewal IDs related to the item.
An array containing subscription IDs related to the item.
An array containing tax IDs related to the item.
An array containing credit card transaction IDs related to the item.
An array containing trial IDs related to the item.
The unix timestamp of when the item was updated.
An array containing usage account invoice IDs related to the item.
An array containing usage account IDs related to the item.
An array containing usage item invoice IDs related to the item.
An array containing usage item IDs related to the item.
The total number of result items for the given request.
The total number of pages for the given request.
Request JSON
{ "request": { "type": "invoice", "method": "retrieve", "id": "bOqOV2gJ6nca1aKq1Ezb" } }
Response JSON
{ "api_call_id": "d959LvNN6ytzWzGvW5J6", "api_call_processed": true, "api_call_unix": 1602978780, "code": 1, "current_count": 1, "current_page": 1, "request_method": "retrieve", "request_type": "invoice", "results": [ { "amount_original_total": 176.79, "amount_total": 176.79, "campaign_id": "X849YQm7BEf0ZQd7Ol1K", "campaign_name": "Facebook Campaign", "check_directs": [], "created_date_unix": 1602978433, "customer": { "address_line_1": "1600 Pennsylvania Ave", "address_line_2": "", "blocked": false, "city": "Washington", "company": "", "country": "USA", "email": "georgew@whitehouse.com", "enabled": true, "first_name": "George", "full_address": "1600 Pennsylvania Ave NW, Washington, DC 20500, USA", "geocode_success": true, "google_place_id": "ChIJGVtI4by3t4kRr51d_Qm_x58", "id": "4r158EzJmmcVM69dNLkg", "internal_id": "pres_0001", "last_name": "Washington", "lat": "38.8976633", "lon": "-77.0365739", "metadata": [], "phone": "1234567890", "state": "DC", "state_long": "DC", "zip": "20500" }, "date_paid": null, "discounts": [], "download_url": "", "hosted_url": "https://securehost.revcent.com/MyCompanyName/invoice?invoice_id=bOqOV2gJ6nca1aKq1Ezb", "id": "bOqOV2gJ6nca1aKq1Ezb", "invoice_profile": { "id": "gYo0YVd24Qf7QvdBYM2O", "name": "tqawqtq" }, "is_sale": true, "is_subscription_renewal": false, "iso_currency": "USD", "license_keys": [], "metadata": [ { "entry_date": "2020-10-17", "name": "invoice_create", "value": "test" } ], "notes": [], "offline_payments": [], "paid": false, "payment_type": null, "paypal_transactions": [], "pending_refunds": [], "product_sales": [], "quota_accounts": [], "revcent_shop": null, "sales": [ "4ryrgOZkvAtKNK9wNv8l" ], "salvage_transactions": [], "shipping": [], "smtp_messages": [], "status": "Unpaid", "subscription_renewals": [], "subscriptions": [], "tax": [], "transactions": [], "trials": [], "updated_date_unix": 1602978433, "usage_account_invoices": [], "usage_accounts": [], "usage_item_invoices": [], "usage_items": [], "void": false } ], "total_count": 1, "total_pages": 1 }
License Key
A license key is created via web app import, remote request or auto generated by RevCent. A license key is issued when a product is purchased that has an attached license key profile. We highly recommend you read more about license key management at our Knowledge Base
License Key Retrieve
Retrieve current information on a single license key or multiple license keys.
Please view Pagination and Filters for details on retrieving multiple items.
The response may include AdWords Response Objects within each item if an AdWords click ID is associated with the item.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The RevCent ID of the license key OR the license key value. Required if multiple property equals false or is not present.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The number of result items contained in the current page.
The current page of result, same as requested page, default is page 1.
The API request method.
The API request type.
An array of objects, each object being a unique item.
The RevCent ID of the campaign.
The name of the campaign associated with the item.
An array containing check direct IDs related to the item.
The unix timestamp of when the item was created.
The customer object.
The customers' first address line.
The customers' second address line.
Whether the customer has been blocked from purchases.
The customers' city.
The customers' company.
The customers' country.
The customers' email.
Whether the customer is currently enabled.
The customers' first name.
The customers' full address.
Whether the customers' address was successfully geocoded using the Google geocoding service.
The Google place ID for the customers' address using the Google geocoding service.
The RevCent ID for the customer.
Your internal ID for the customer.
The customers' last name.
The approximate latitude for the customers' address using the Google geocoding service.
The approximate longitude for the customers' address using the Google geocoding service.
The customers' phone number.
The customers' state.
The customers' state in long format.
The customers' status.
The customers' zip or postal code.
An array containing discounts related to the item.
Whether the license key is currently enabled.
The date the license key was expired. Only for keys with a license key profile with expired settings.
The date as a unix timestamp the license key was expired. Only for keys with a license key profile with expired settings.
The RevCent ID of the object item.
The internal_id you provided when creating the item.
An array containing invoice IDs related to the item.
Whether the license key is expired after being issued.
Whether the license key has been issued as a result of a successful purchase.
The date the license key was issued as a result of a successful purchase.
The date as a unix timestamp the license key was issued as a result of a successful purchase.
The license key profile related to the license key.
The RevCent ID of the object item.
The name of the item.
The source of the license key. Remote, imported or RevCent generated.
An array containing offline payment IDs related to the item.
An array containing RevCent PayPal transaction IDs related to the item.
An array containing pending refund IDs related to the item.
An array containing product sale IDs related to the item.
The RevCent ID of the object item.
An array containing sale IDs related to the item.
An array containing salvage transaction IDs related to the item.
An array containing shipping IDs related to the item.
An array containing SMTP message IDs related to the item.
The current status of the related item.
An array containing subscription renewal IDs related to the item.
An array containing subscription IDs related to the item.
An array containing tax IDs related to the item.
The third party shop related to the item.
An array containing credit card transaction IDs related to the item.
An array containing trial IDs related to the item.
The unix timestamp of when the item was updated.
An array containing usage account invoice IDs related to the item.
An array containing usage account IDs related to the item.
An array containing usage item invoice IDs related to the item.
An array containing usage item IDs related to the item.
The total number of result items for the given request.
The total number of pages for the given request.
Request JSON
{ "request": { "type": "license_key", "method": "retrieve", "id": "0pZwRNgwKwIXvMKKBbpZ" } }
Response JSON
{ "api_call_id": "KngPNGlrqvikawbWlGXr", "api_call_processed": true, "api_call_unix": 1592237703, "code": 1, "current_count": 1, "current_page": 1, "request_method": "retrieve", "request_type": "license_key", "results": [ { "campaign_id": "mJ1zZoOobEuP8pnWKXd1", "campaign_name": "Adwords Campaign", "check_directs": [], "created_date_unix": 1591892064, "customer": { "address_line_1": "1600 Pennsylvania Ave", "address_line_2": "", "blocked": false, "city": "Washington", "company": "", "country": "USA", "email": "georgew@whitehouse.com", "enabled": true, "first_name": "George", "full_address": "1600 Pennsylvania Ave NW, Washington, DC 20500, USA", "geocode_success": true, "google_place_id": "ChIJGVtI4by3t4kRr51d_Qm_x58", "id": "4r158EzJmmcVM69dNLkg", "internal_id": "pres_0001", "last_name": "Washington", "lat": "38.8976633", "lon": "-77.0365739", "metadata": [], "phone": "1234567890", "state": "DC", "state_long": "DC", "zip": "20500" }, "discounts": [ "LYg5NmwXlYhJoyll4wgZ" ], "enabled": true, "expired_date": null, "expired_date_unix": null, "id": "0pZwRNgwKwIXvMKKBbpZ", "internal_id": "", "invoices": [], "is_expired": false, "is_issued": true, "issued_date": "2020-06-11T16:14:30+00:00", "issued_date_unix": 1591892070, "license_key_profile": { "id": "0pZwpLpPw4UrdOkQpqyv", "name": "Imported Keys Only" }, "license_key_source": "imported", "notes": [], "offline_payments": [], "paypal_transactions": [], "pending_refunds": [], "product_sales": [ "P6g5kEaEzjt6VyllpEGL" ], "sale": { "id": "qZEBboR8W0hOPpVV02rZ" }, "sales": [ "qZEBboR8W0hOPpVV02rZ" ], "salvage_transactions": [], "shipping": [], "smtp_messages": [], "status": "Enabled", "subscription_renewals": [], "subscriptions": [], "tax": [ "ZV7EmNBNP5TA7122OyKX" ], "third_party_shop": null, "transactions": [ "EMgw2p6q5MfEnm55pPag" ], "trials": [], "updated_date_unix": 1591892070, "usage_account_invoices": [], "usage_accounts": [], "usage_item_invoices": [], "usage_items": [] } ], "total_count": 1, "total_pages": 1 }
Request JSON
{ "request": { "type": "metadata", "method": "insert", "item_type": "sale", "item_id": "pgm1q7yjKjF7qyAM7EXK", "cascade": false, "metadata": [ { "name": "new_name", "value": "new value" } ] } }
Response JSON
{ "api_call_date": "2022-06-02T15:16:15+00:00", "api_call_id": "JNGoAdZ7v8iRooaArOOy", "api_call_processed": true, "api_call_unix": 1654182975, "code": 1, "customer": { "address_line_1": "1600 Pennsylvania Ave", "address_line_2": "", "blocked": false, "city": "Washington", "company": "", "country": "USA", "email": "georgew@whitehouse.com", "enabled": true, "first_name": "George", "full_address": "1600 Pennsylvania Ave NW, Washington, DC 20500, USA", "geocode_success": true, "google_place_id": "ChIJGVtI4by3t4kRr51d_Qm_x58", "id": "4r158EzJmmcVM69dNLkg", "internal_id": "pres_0001", "last_name": "Washington", "lat": "38.8976633", "lon": "-77.0365739", "metadata": [], "phone": "1234567890", "state": "DC", "state_long": "DC", "zip": "20500" }, "item_id": "pgm1q7yjKjF7qyAM7EXK", "item_type": "sale", "metadata": [ { "name": "new_name", "value": "new value" } ], "request_method": "insert", "request_type": "metadata", "result": "Metadata inserted." }
Note
You can create a note for an entity within RevCent that will simultaneously attach the note to the customer related to the entity. This allows you to view all notes for a customer and related entities.
Note Create
Create a note for a specific entity such as a customer, sale, shipping, etc. Indicate the entity using the item_type and item_id properties, the item_type being either sale, customer, shipping, etc., and item_id being the RevCent ID for the item. For example, if you want to leave a note for a sale, set item_type = "sale" and item_id="REVCENT_SALE_ID".
Accepted Item Types
- customer
- A customer within RevCent.
- sale
- A sale within RevCent.
- product_sale
- A product sale within RevCent.
- shipping
- A shipping within RevCent.
- subscription
- A subscription within RevCent.
- subscription_renewal
- A subscription renewal within RevCent.
- chargeback
- A chargeback within RevCent.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The item type the note is to be created for. Example: sale, customer, shipping, etc.
The RevCent ID for the item the note is to be created for. If item_type = sale, then the RevCent sale ID.
The note text.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The RevCent ID for the item the note was created for.
The item type the note was created for.
The RevCent ID for the note created.
The API request method.
The API request type.
The a brief description of the result of the API call.
Request JSON
{ "request": { "type": "note", "method": "create", "item_type": "sale", "item_id": "pgm1q7yjKjF7qyAM7EXK", "text": "Making a note for a sale with RevCent ID pgm1q7yjKjF7qyAM7EXK." } }
Response JSON
{ "api_call_id": "WmEZRkNmKRhmWBrkNP9B", "api_call_processed": true, "api_call_unix": 1638047347, "code": 1, "item_id": "pgm1q7yjKjF7qyAM7EXK", "item_type": "sale", "note_id": "4rAmyMargyuMaXrkQLyK", "request_method": "create", "request_type": "note", "result": "Note created." }
Payments
RevCent supports multiple payment types including check, credit card, offline and PayPal. Depending on the payment type, different methods are supported.
Additional payment types will be added in the future including Amazon Pay, Apply Pay and Google Pay.
Check Direct
A check direct is considered a physical check, not ACH or electronic check. The physicality is what separates a check direct from electronic forms of check payments, along with the accounts receivable and mailing aspects. ACH and electronic check methods will be supported in the near future as a separate entity.
Check Direct Refund
To refund a check direct you instead refund the entity that the refund is associated with, i.e. sale, product_sale, tax, shipping, etc.
Check Direct Retrieve
Retrieve current information on a single check direct or multiple check directs.
Please view Pagination and Filters for details on retrieving multiple items.
The response may include AdWords Response Objects within each item if an AdWords click ID is associated with the item.
Request JSON Schema
The main request object.
The type of request being made.
The method for the request type.
The RevCent ID of the item. Required if multiple property equals false or is not present.
Whether it is a multiple type request.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The number of result items contained in the current page.
The current page of result, same as requested page, default is page 1.
The API request method.
The API request type.
An array of objects, each object being a unique item.
The amount of the item.
The RevCent ID of the campaign.
The name of the campaign associated with the item.
The check number.
The unix timestamp of when the item was created.
The customer object.
The customers' first address line.
The customers' second address line.
Whether the customer has been blocked from purchases.
The customers' city.
The customers' company.
The customers' country.
The customers' email.
Whether the customer is currently enabled.
The customers' first name.
The customers' full address.
Whether the customers' address was successfully geocoded using the Google geocoding service.
The Google place ID for the customers' address using the Google geocoding service.
The RevCent ID for the customer.
Your internal ID for the customer.
The customers' last name.
The approximate latitude for the customers' address using the Google geocoding service.
The approximate longitude for the customers' address using the Google geocoding service.
The customers' phone number.
The customers' state.
The customers' state in long format.
The customers' status.
The customers' zip or postal code.
An array containing discounts related to the item.
The RevCent ID of the object item.
An array containing offline payment IDs related to the item.
An array containing RevCent PayPal transaction IDs related to the item.
An array containing pending refund IDs related to the item.
An array containing product sale IDs related to the item.
Whether the check has been received.
An array containing sale IDs related to the item.
An array containing salvage transaction IDs related to the item.
An array containing shipping IDs related to the item.
An array containing SMTP message IDs related to the item.
The current status of the related item.
An array containing subscription renewal IDs related to the item.
An array containing subscription IDs related to the item.
An array containing tax IDs related to the item.
Will contain details if the root item is related to a third party shop.
The RevCent ID of the object item.
The name of the item.
The URL of the third party shop.
An array containing credit card transaction IDs related to the item.
An array containing trial IDs related to the item.
The unix timestamp of when the item was updated.
The total number of result items for the given request.
The total number of pages for the given request.
Request JSON
{ "request": { "type": "check_direct", "method": "retrieve", "id": "GO51EXbbAPS6pP1Ov9kK" } }
Response JSON
{ "api_call_id": "9rdXJQ5z4bcLYqLkV656", "api_call_processed": true, "api_call_unix": 1566160507, "code": 1, "current_count": 1, "current_page": 1, "request_method": "retrieve", "request_type": "check_direct", "results": [ { "amount": 201.58, "campaign_id": "mJ1zZoOobEuP8pnWKXd1", "campaign_name": "Adwords Campaign", "check_number": "", "created_date_unix": 1565832518, "customer": { "address_line_1": "1600 Pennsylvania Ave", "address_line_2": "", "blocked": false, "city": "Washington", "company": "", "country": "USA", "email": "georgew@whitehouse.com", "enabled": true, "first_name": "George", "full_address": "1600 Pennsylvania Ave NW, Washington, DC 20500, USA", "geocode_success": true, "google_place_id": "ChIJGVtI4by3t4kRr51d_Qm_x58", "id": "4r158EzJmmcVM69dNLkg", "internal_id": "pres_0001", "last_name": "Washington", "lat": "38.8976633", "lon": "-77.0365739", "metadata": [], "phone": "1234567890", "state": "DC", "state_long": "DC", "zip": "20500" }, "discounts": [], "id": "GO51EXbbAPS6pP1Ov9kK", "notes": [], "offline_payments": [], "paypal_transactions": [], "pending_refunds": [], "product_sales": [ "5r1MyL99VouMNRl9Pnkd", "d9ZolGRRwnu6lZb2Jo64", "WmPn2q99GzSKXWmbJjVd" ], "received": true, "sales": [ "1rQAp8MM46uzN4Rw0Kgk" ], "salvage_transactions": [], "shipping": [ "X8anGkNN5XfZK5mK06VX" ], "smtp_messages": [], "status": "Received", "subscription_renewals": [], "subscriptions": [ "nbM1P5aa2VfNvVJvWjb1", "WmPn2q99GzSKRnQjZmkz" ], "tax": [ "k6vn8JZZAmUv8G5z6klR" ], "third_party_shop": { "id": "Q48aAbVv21fJRvNKWrvP", "name": "My Shop", "shop_url": "myshop.com" }, "transactions": [], "trials": [], "updated_date_unix": 1565832519 } ], "total_count": 1, "total_pages": 1 }
Credit Card
Credit card payments are supported via merchant gateway integrations. Integrate a merchant gateway within the RevCent web app. Once integrated you can conduct most payment actions, and RevCent updates transaction status to reflect payment settlement.
Transaction
A credit card transaction can be two types, either a payment is captured, or a refund where a previous payment is refunded. RevCent only supports the auth-capture method when processing a payment, auth-only is not supported.
Transaction Create Refund
Refund a credit card transaction directly. This is not the recommended method if you wish to run detailed metrics reports. Use either Product Sale Refund, Shipping Refund, or Subscription Renewal Refund instead.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The RevCent ID of the credit card transaction.
The amount to refund. If not provided the entire transaction amount will be refunded.
You have the option to refund a credit card transaction within RevCent, without refunding the transaction at the gateway level. If set to true, RevCent will mark all entities as having a refund, but will not contact the gateway to return the money to the customer. This is useful for reporting within RevCent when a transaction was refunded outside of RevCent, i.e. Rapid Dispute Resolution, mailed a check, etc. Default is false.
Response JSON Schema
The amount of the item.
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The campaign ID of the transaction being refunded.
The customer ID of the transaction being refunded.
The sale ID of the transaction being refunded.
The ID of the transaction being refunded.
Array containing IDs of each pending refund created as a result of the request.
Array containing IDs of each product sale refunded as a result of the request.
Indicates whether the transaction was refunded using the refunded_offsite = true flag.
The API request method.
The API request type.
The a brief description of the result of the API call.
Array containing IDs of each shipping refunded as a result of the request.
Array containing IDs of each tax refunded as a result of the request.
Request JSON
{ "request": { "type": "transaction", "method": "create_refund", "transaction_id": "ALRjyqRE27fjMonyKLny", "refunded_offsite": false, "amount": 1.25 } }
Response JSON
{ "amount": 1.25, "api_call_id": "0pwokmGgzRc0yg8dXp7q", "api_call_processed": true, "api_call_unix": 1565814903, "code": 1, "origin_campaign_id": "X849YQm7BEf0ZQd7Ol1K", "origin_customer_id": "4r158EzJmmcVM69dNLkg", "origin_sale_id": "k6vnbJom00Ug89mpRj78", "origin_transaction_id": "ALRjyqRE27fjMonyKLny", "pending_refund": [ "MW5LoAVymnHww96XllEr", "vEwWrAjn8RcM9yQdyjOy", "9rdEMaP59RuYg41zRJwW", "Nk5voyEw8YiOmaRvjgyG" ], "product_sale_refunded": [ "LY5yop5nk7hbPzpBn8aY", "9rdEMadyZ7uYgnbKWwX5" ], "refunded_offsite": false, "request_method": "create_refund", "request_type": "transaction", "result": "Pending refund created for transaction.", "shipping_refunded": [ "gYamRbaGZphKn8zJVow1" ], "tax_refunded": [ "ALRjyqRE27fjjpmRzBRd" ] }
Transaction Retrieve
Retrieve current information on a single transaction or multiple transactions. You can use the RevCent ID or gateway transaction id as the id value when retrieving a single transaction.
Please view Pagination and Filters for details on retrieving multiple items.
The response may include AdWords Response Objects within each item if an AdWords click ID is associated with the item.
Request JSON Schema
The main request object.
The request type.
The request method.
The RevCent ID of the transaction or the gateway transaction ID of the transaction. Required if multiple property equals false and email property not present.
Whether it is a multiple type request.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The number of result items contained in the current page.
The current page of result, same as requested page, default is page 1.
The API request method.
The API request type.
An array of objects, each object being a unique item.
The amount of the item.
The amount captured.
The current amount of calculated fees charged by the payment processor.
The current gross amount. Equals (amount_captured + amount_settled).
The current net amount. Equals (amount_captured + amount_settled) - amount_fees.
The total calculated amount when an item is created.
Total amount of any refunds.
The current amount remaining to be captured. Amounts yet to be captured due to a trial or salvage transaction.
The current amount settled.
The current total amount after any refunds, cancellations or other changes. Equals amount_original_total - (amount_void + amount_refunded).
Total amount of any items that have been voided.
Whether the transaction was approved.
The RevCent ID of the campaign.
The name of the campaign associated with the item.
Whether the transaction was captured.
An array containing check direct IDs related to the item.
The result code for the request.
0 = RevCent Error
1 = Success
The unix timestamp of when the item was created.
The customer object.
The customers' first address line.
The customers' second address line.
Whether the customer has been blocked from purchases.
The customers' city.
The customers' company.
The customers' country.
The customers' email.
Whether the customer is currently enabled.
The customers' first name.
The customers' full address.
Whether the customers' address was successfully geocoded using the Google geocoding service.
The Google place ID for the customers' address using the Google geocoding service.
The RevCent ID for the customer.
Your internal ID for the customer.
The customers' last name.
The approximate latitude for the customers' address using the Google geocoding service.
The approximate longitude for the customers' address using the Google geocoding service.
The customers' phone number.
The customers' state.
The customers' state in long format.
The customers' status.
The customers' zip or postal code.
The customer credit card associated with the transaction.
The unix timestamp of when the item was created.
The unix timestamp of when the item was updated.
The RevCent ID of the object item.
The credit card type
The last four digits of the credit card.
Whether the transaction was declined.
The unix timestamp of when RevCent requested details on the transaction status.
The latest response from the merchant gateway when RevCent requested details on the transaction status.
An array containing discounts related to the item.
Whether the transaction had an error.
The RevCent ID of the gateway.
The name of the gateway.
Whether the transaction has an associated salvage transaction.
Whether the transaction was held.
The RevCent ID of the object item.
Whether the transaction is part of a payment profile request.
Whether the transaction is a refund transaction.
Whether the transaction is a salvage transaction.
Whether the transaction is a subscription transaction.
Whether the transaction is a subscription renewal transaction.
Whether the item was created using a live or test RevCent API key.
An array containing offline payment IDs related to the item.
Payment profile related to the item.
The RevCent ID of the object item.
The name of the item.
An array of objects, each object being a unique item.
An array containing RevCent PayPal transaction IDs related to the item.
An array containing pending refund IDs related to the item.
An array containing product sale IDs related to the item.
The result of the transaction request.
Whether the transaction is an initial sale transaction.
An array containing sale IDs related to the item.
An array containing salvage transaction IDs related to the item.
Whether the transaction has been settled.
An array containing shipping IDs related to the item.
An array containing SMTP message IDs related to the item.
The current status of the related item.
Details on the subscription profile associated with the subscription.
The RevCent ID of the object item.
The name of the item.
The description of the item.
If the number of renewals allowed is specific or indefinite.
If occurrences = specific, then the number of occurrence allowed.
Whether the subscription profile is specific to a single subscription. I.e. customized.
If the subscription profile is specific to a single subscription, the subscription ID.
The frequency setting. Either unit, calendar or fiscal.
The unit based frequency settings for the subscription profile.
The frequency unit value.
The frequency unit, i.e. days, weeks, months or years.
The calendar based frequency settings for the subscription profile.
The calendar unit, i.e. The 2nd X of every month.
The calendar value, i.e. The X day of every month.
The calendar parent, i.e. The 2nd day of every X
The fiscal based frequency settings for the subscription profile.
The fiscal setting. Either standard or infrequent. If standard, then Quarterly or Yearly. If infrequent then fiscal_unit and fiscal_value determine schedule.
The fiscal value when fiscal_setting = infrequent, i.e. every X quarter.
The fiscal unit when fiscal_setting = infrequent, i.e. every 2 X.
An array containing subscription renewal IDs related to the item.
An array containing subscription IDs related to the item.
An array containing tax IDs related to the item.
Will contain details if the root item is related to a third party shop.
The RevCent ID of the object item.
The name of the item.
The URL of the third party shop.
An array containing trial IDs related to the item.
The unix timestamp of when the item was updated.
Whether the transaction is void.
The total number of result items for the given request.
The total number of pages for the given request.
Request JSON
{ "request": { "type": "transaction", "method": "retrieve", "id": "ALRjyqRE27fjMonyKLny" } }
Response JSON
{ "api_call_id": "o1jGw57PVgFLLMJ8VJW7", "api_call_processed": true, "api_call_unix": 1565814903, "code": 1, "current_count": 1, "current_page": 1, "request_method": "retrieve", "request_type": "transaction", "results": [ { "amount": 111.86, "amount_captured": 111.86, "amount_fees": 3.02, "amount_gross": 111.86, "amount_net": 108.84, "amount_original_total": 111.86, "amount_refunded": 0, "amount_remaining": 0, "amount_settled": 0, "amount_total": 111.86, "amount_void": 0, "approved": true, "campaign_id": "X849YQm7BEf0ZQd7Ol1K", "campaign_name": "Facebook Campaign", "captured": true, "check_directs": [], "code": 1, "created_date_unix": 1565814901, "customer": { "address_line_1": "1600 Pennsylvania Ave", "address_line_2": "", "blocked": false, "city": "Washington", "company": "", "country": "USA", "email": "georgew@whitehouse.com", "enabled": true, "first_name": "George", "full_address": "1600 Pennsylvania Ave NW, Washington, DC 20500, USA", "geocode_success": true, "google_place_id": "ChIJGVtI4by3t4kRr51d_Qm_x58", "id": "4r158EzJmmcVM69dNLkg", "internal_id": "pres_0001", "last_name": "Washington", "lat": "38.8976633", "lon": "-77.0365739", "metadata": [], "phone": "1234567890", "state": "DC", "state_long": "DC", "zip": "20500" }, "customer_card": { "type": "visa", "id": "1rQA58w6XXcMNRApYLPn", "last_4": "4242", "created_date_unix": 1565814899, "updated_date_unix": 1565814901, "expiry_date": "11/2023", "expiry_month": "11", "expiry_year": "2023" }, "declined": false, "details_last_updated_unix": null, "details_response": "", "discounts": [], "error": false, "gateway_id": "NkAMJOzpB5iEAOrdloV0", "gateway_name": "Braintree", "has_salvage": true, "held": false, "id": "ALRjyqRE27fjMonyKLny", "is_payment_profile": false, "is_refund": false, "is_salvage": false, "is_subscription": false, "is_subscription_renewal": false, "live_mode": false, "metadata": [ { "name": "adwords_click", "value": "Cjat0KwhCQjdTq..." } ], "notes": [], "offline_payments": [], "payment_profile": { "id": "ajyXm76OpjSL4p5oO2By", "name": "AuthBrainStripe", "results": null }, "paypal_transactions": [], "pending_refunds": [], "product_sales": [ "9rdEMadyZ7uYgnbKWwX5", "LY5yop5nk7hbPzpBn8aY" ], "result": "Approved", "sale_initial": true, "sales": [ "k6vnbJom00Ug89mpRj78" ], "salvage_transactions": [ "VPm9Mqmgw7UJJLldojJY" ], "settled": false, "shipping": [ "gYamRbaGZphKn8zJVow1" ], "smtp_messages": [], "status": "Fully Captured", "subscription_profile": null, "subscription_renewals": [], "subscriptions": [ "o1jGw5jY2RILLl4dBMwa" ], "tax": [ "ALRjyqRE27fjjpmRzBRd" ], "third_party_shop": null, "trials": [], "updated_date_unix": 1565814901, "void": false } ], "total_count": 1, "total_pages": 1 }
Transaction Search
Search for a transaction using a string or group of strings.
Please read more about API Search before proceeding.
Request JSON Schema
The main request object.
The type of request being made.
The method for the request type.
The string to search.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The API request type.
The API request method.
An array of objects, each object being a unique item.
The RevCent ID of the object item.
The unix timestamp of when the item was created.
The RevCent ID of the customer.
The RevCent ID of the customer credit card used if a transaction occurred.
The transaction ID assigned by the merchant gateway.
The API request type.
The API request method.
Request JSON
{ "request": { "type": "transaction", "method": "search", "search_term": "424242 4242" } }
Response JSON
{ "api_call_id": "d9gW26qJVVurkPWX4nBb", "api_call_processed": true, "api_call_unix": 1681160220, "code": 1, "request_type": "transaction", "request_method": "search", "results": [ { "item_type": "transaction", "id": "1rBrrKwjbVH885Jb078K", "created_date_unix": 1680909459, "customer_id": "gYQYYJlMXYHXXL709WlR", "first_name": "zqhy", "last_name": "tyxpeqkk", "email": "xbim32@gmail.com", "card_id": "wLvLLNmgJLH11GZ4qNdZ", "first_6": "400000", "last_4": "0002", "gateway_transaction_id": "60214190393", "request_type": "sale", "request_method": "create", "approved": true, "metadata": [], "url": "https://revcent.com/user/transaction-details/1rBrrKwjbVH885Jb078K", "highlights": [ { "field": "gateway_transaction_id", "values": [ "60214190393" ] } ], "score": 7.79 } ] }
Offline Payment
An offline payment is essentially a cash or any other means of exchange which needs to be recorded. Offline payments are also useful during replacements, rebates, etc.
Offline Payment Refund
To refund an offline payment you instead refund the entity that the refund is associated with, i.e. sale, product_sale, tax, shipping, etc.
Offline Payment Retrieve
Retrieve current information on a single offline payment or multiple offline payments.
Please view Pagination and Filters for details on retrieving multiple items.
The response may include AdWords Response Objects within each item if an AdWords click ID is associated with the item.
Request JSON Schema
The main request object.
The type of request being made.
The method for the request type.
The RevCent ID of the item. Required if multiple property equals false or is not present.
Whether it is a multiple type request.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The number of result items contained in the current page.
The current page of result, same as requested page, default is page 1.
The API request method.
The API request type.
An array of objects, each object being a unique item.
The amount of the item.
The RevCent ID of the campaign.
The name of the campaign associated with the item.
An array containing check direct IDs related to the item.
The unix timestamp of when the item was created.
The customer object.
The customers' first address line.
The customers' second address line.
Whether the customer has been blocked from purchases.
The customers' city.
The customers' company.
The customers' country.
The customers' email.
Whether the customer is currently enabled.
The customers' first name.
The customers' full address.
Whether the customers' address was successfully geocoded using the Google geocoding service.
The Google place ID for the customers' address using the Google geocoding service.
The RevCent ID for the customer.
Your internal ID for the customer.
The customers' last name.
The approximate latitude for the customers' address using the Google geocoding service.
The approximate longitude for the customers' address using the Google geocoding service.
The customers' phone number.
The customers' state.
The customers' state in long format.
The customers' status.
The customers' zip or postal code.
An array containing discounts related to the item.
The RevCent ID of the object item.
An array containing RevCent PayPal transaction IDs related to the item.
An array containing pending refund IDs related to the item.
An array containing product sale IDs related to the item.
An array containing sale IDs related to the item.
An array containing salvage transaction IDs related to the item.
An array containing shipping IDs related to the item.
An array containing SMTP message IDs related to the item.
The current status of the related item.
An array containing subscription renewal IDs related to the item.
An array containing subscription IDs related to the item.
An array containing tax IDs related to the item.
Will contain details if the offline payment is related to a third party integration, such as Sezzle, Afterpay, etc.
The ID of the user third party integration.
The name of the user third party integration.
Will contain details of the actual third party responsible for the offline payment.
The ID of the third party.
The name of the third party.
Will contain details if the root item is related to a third party shop.
The RevCent ID of the object item.
The name of the item.
The URL of the third party shop.
An array containing credit card transaction IDs related to the item.
An array containing trial IDs related to the item.
The unix timestamp of when the item was updated.
The total number of result items for the given request.
The total number of pages for the given request.
Request JSON
{ "request": { "type": "offline_payment", "method": "retrieve", "id": "zGldyKJGORfkP1O1vJ4B" } }
Response JSON
{ "api_call_id": "gYagkq56lAsJn0K98Y4M", "api_call_processed": true, "api_call_unix": 1566160508, "code": 1, "current_count": 1, "current_page": 1, "request_method": "retrieve", "request_type": "offline_payment", "results": [ { "amount": 255.92, "campaign_id": "JN0Zpj7RGJiwKqAnRoy6", "campaign_name": "Twitter Campaign", "check_directs": [], "created_date_unix": 1565830657, "customer": { "address_line_1": "1600 Pennsylvania Ave", "address_line_2": "", "blocked": false, "city": "Washington", "company": "", "country": "USA", "email": "georgew@whitehouse.com", "enabled": true, "first_name": "George", "full_address": "1600 Pennsylvania Ave NW, Washington, DC 20500, USA", "geocode_success": true, "google_place_id": "ChIJGVtI4by3t4kRr51d_Qm_x58", "id": "4r158EzJmmcVM69dNLkg", "internal_id": "pres_0001", "last_name": "Washington", "lat": "38.8976633", "lon": "-77.0365739", "metadata": [], "phone": "1234567890", "state": "DC", "state_long": "DC", "zip": "20500" }, "discounts": [ "6r1EpBQrbRCz91q8E6qb" ], "id": "zGldyKJGORfkP1O1vJ4B", "notes": [], "paypal_transactions": [], "pending_refunds": [], "product_sales": [ "BvwOk6VvpEs17GrozWaa", "gYamd2VYr9h4M5zOE7zN", "o1jGQnO1m4iQWpYjNaB6" ], "sales": [ "4r15pjKr4RCraznBnvZ1" ], "salvage_transactions": [], "shipping": [ "qZBAQK9Zabf4KgXRPmvA" ], "smtp_messages": [], "status": "Complete", "subscription_renewals": [], "subscriptions": [ "Kn51QPBnE9iGE5mmBRqA" ], "tax": [ "bOBywapOAGtjzk9PjWyd" ], "third_party_integration": { "id": "Q4l9bmQvLVCW72AmEZEg", "name": "My Sezzle Integration", "third_party": { "id": "6rlY0B40mVfzVXmL1yyP", "name": "Sezzle" } }, "third_party_shop": { "id": "Q48aAbVv21fJRvNKWrvP", "name": "My Shop", "shop_url": "myshop.com" }, "transactions": [], "trials": [], "updated_date_unix": 1565830657 } ], "total_count": 1, "total_pages": 1 }
PayPal
Integrate your PayPal account(s) with RevCent using the web app and PayPal API credentials. Integrating PayPal with RevCent has several benefits, including dispute detection. PayPal payments made via third party shops and hosted pages are automatically integrated within RevCent.
PayPal Dispute
Once you have integrated your PayPal account with RevCent, we will continuously monitor your PayPal account for any disputes.
RevCent will create a dispute item when a new dispute is found, and attempt to link the specific dispute to a known PayPal transaction within RevCent. Dispute action must be taken within PayPal. We do plan, in the future, to add the ability to take action within RevCent.
PayPal Dispute Retrieve
Retrieve current information on a single PayPal dispute or multiple PayPal disputes.
Please view Pagination and Filters for details on retrieving multiple items.
Request JSON Schema
The main request object.
The type of request being made.
The method for the request type.
The RevCent ID of the item. Required if multiple property equals false or is not present.
Whether it is a multiple type request.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The number of result items contained in the current page.
The current page of result, same as requested page, default is page 1.
The API request method.
The API request type.
An array of objects, each object being a unique item.
The unix timestamp of when the item was created.
The RevCent ID of the object item.
The PayPal account you integrated with RevCent.
The RevCent ID of the object item.
The name of the item.
The email address within PayPal for this specific account.
The exact API response RevCent received regarding the PayPal dispute.
The amount disputed, from paypal_details_response.
The date the dispute was created within PayPal, from paypal_details_response
The unix timestamp of when the dispute was created within PayPal, from paypal_details_response
The PayPal dispute ID, from paypal_details_response
Dispute outcome, from paypal_details_response
The date the dispute was last updated within PayPal, from paypal_details_response.
The unix timestamp of when the dispute was last updated within PayPal, from paypal_details_response.
PayPal messages, from paypal_details_response.
The dispute reason, from paypal_details_response.
The status within PayPal, from paypal_details_response.
The unix timestamp of when the item was updated.
The total number of result items for the given request.
The total number of pages for the given request.
Request JSON
{ "request": { "type": "paypal_dispute", "method": "retrieve", "id": "wLzYlmJdqGiM0RlvvLKp" } }
Response JSON
{ "api_call_id": "ZVE5YRjd7RsXdJmN02pp", "api_call_processed": true, "api_call_unix": 1566160506, "code": 1, "current_count": 1, "current_page": 1, "request_method": "retrieve", "request_type": "paypal_dispute", "results": [ { "created_date_unix": 1565956199, "id": "wLzYlmJdqGiM0RlvvLKp", "paypal_account": { "id": "mJVWkmzVz0i42j0GEVK4", "name": "My PayPal Account", "paypal_account_email": "myemail@gmail.com" }, "paypal_details_response": "", "paypal_dispute_amount": 89.98, "paypal_dispute_created_date": "2019-08-16T09:27:24+00:00", "paypal_dispute_created_date_unix": 1565947644, "paypal_dispute_id": "PP-D-XXXXXXXXX", "paypal_dispute_outcome": "", "paypal_dispute_updated_date": "2019-08-16T10:31:35+00:00", "paypal_dispute_updated_date_unix": 1565951495, "paypal_messages": [ { "posted_by": "BUYER", "time_posted": "2019-08-16T09:27:30.000Z", "content": "Did not receive product." } ], "paypal_reason": "MERCHANDISE_OR_SERVICE_NOT_RECEIVED", "paypal_status": "OPEN", "updated_date_unix": 1566129063 } ], "total_count": 1, "total_pages": 1 }
PayPal Transaction
A PayPal transaction is created within RevCent when a PayPal sale takes place via shopping cart plugin or a RevCent hosted page. RevCent confirms all transactions with PayPal and receives transaction details via the PayPal API.
RevCent also monitors your PayPal account for disputes, and will link disputes to existing transactions when detected.
PayPal Transaction Refund
To refund a PayPal transaction you instead refund the entity that the refund is associated with, the same as you would a credit card transaction. Refunding a sale, shipping, or tax will automatically refund any PayPal transactions using the PayPal API.
PayPal Transaction Retrieve
Retrieve current information on a single PayPal transaction or multiple PayPal transactions.
Please view Pagination and Filters for details on retrieving multiple items.
The response may include AdWords Response Objects within each item if an AdWords click ID is associated with the item.
Request JSON Schema
The main request object.
The type of request being made.
The method for the request type.
The RevCent ID of the item. Required if multiple property equals false or is not present.
Whether it is a multiple type request.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The number of result items contained in the current page.
The current page of result, same as requested page, default is page 1.
The API request method.
The API request type.
An array of objects, each object being a unique item.
The amount captured.
The current amount of calculated fees charged by the payment processor.
The current gross amount. Equals (amount_captured + amount_settled).
The current net amount. Equals (amount_captured + amount_settled) - amount_fees.
The total calculated amount when an item is created.
Total amount of any refunds.
PayPal transactions do not receive an amount_remaining, as they are considered complete when created.
PayPal transactions do not receive an amount_settled, as they are considered complete when created.
The current total amount after any refunds, cancellations or other changes. Equals amount_original_total - (amount_void + amount_refunded).
The RevCent ID of the campaign.
The name of the campaign associated with the item.
An array containing check direct IDs related to the item.
The unix timestamp of when the item was created.
The customer object.
The customers' first address line.
The customers' second address line.
Whether the customer has been blocked from purchases.
The customers' city.
The customers' company.
The customers' country.
The customers' email.
Whether the customer is currently enabled.
The customers' first name.
The customers' full address.
Whether the customers' address was successfully geocoded using the Google geocoding service.
The Google place ID for the customers' address using the Google geocoding service.
The RevCent ID for the customer.
Your internal ID for the customer.
The customers' last name.
The approximate latitude for the customers' address using the Google geocoding service.
The approximate longitude for the customers' address using the Google geocoding service.
The customers' phone number.
The customers' state.
The customers' state in long format.
The customers' status.
The customers' zip or postal code.
An array containing discounts related to the item.
The RevCent ID of the object item.
An array containing offline payment IDs related to the item.
The PayPal account you integrated with RevCent.
The RevCent ID of the object item.
The name of the item.
The email address within PayPal for this specific account.
The customer ID within PayPal.
The transaction amount within PayPal.
The transaction date within PayPal.
The transaction unix timestamp within PayPal.
The PayPal transaction ID.
An array containing pending refund IDs related to the item.
An array containing product sale IDs related to the item.
An array containing sale IDs related to the item.
An array containing salvage transaction IDs related to the item.
An array containing shipping IDs related to the item.
An array containing SMTP message IDs related to the item.
An array containing subscription renewal IDs related to the item.
An array containing subscription IDs related to the item.
An array containing tax IDs related to the item.
Will contain details if the root item is related to a third party shop.
The RevCent ID of the object item.
The name of the item.
The URL of the third party shop.
An array containing credit card transaction IDs related to the item.
An array containing trial IDs related to the item.
The unix timestamp of when the item was updated.
The total number of result items for the given request.
The total number of pages for the given request.
Request JSON
{ "request": { "type": "paypal_transaction", "method": "retrieve", "id": "k6omOdKbrRTZnpP6d7Ng" } }
Response JSON
{ "api_call_id": "4r1ZLyqwrvcq9qLbA0qo", "api_call_processed": true, "api_call_unix": 1566160506, "code": 1, "current_count": 1, "current_page": 1, "request_method": "retrieve", "request_type": "paypal_transaction", "results": [ { "amount_captured": 0.01, "amount_fees": 0, "amount_gross": 0.01, "amount_net": 0.01, "amount_original_total": 0.01, "amount_refunded": 0, "amount_remaining": 0, "amount_settled": 0, "amount_total": 0.01, "campaign_id": "JN0Zpj7RGJiwKqAnRoy6", "campaign_name": "Twitter Campaign", "check_directs": [], "created_date_unix": 1562082423, "customer": { "address_line_1": "1600 Pennsylvania Ave", "address_line_2": "", "blocked": false, "city": "Washington", "company": "", "country": "USA", "email": "georgew@whitehouse.com", "enabled": true, "first_name": "George", "full_address": "1600 Pennsylvania Ave NW, Washington, DC 20500, USA", "geocode_success": true, "google_place_id": "ChIJGVtI4by3t4kRr51d_Qm_x58", "id": "4r158EzJmmcVM69dNLkg", "internal_id": "pres_0001", "last_name": "Washington", "lat": "38.8976633", "lon": "-77.0365739", "metadata": [], "phone": "1234567890", "state": "DC", "state_long": "DC", "zip": "20500" }, "discounts": [], "id": "k6omOdKbrRTZnpP6d7Ng", "metadata": [ { "name": "adwords_click", "value": "Cjat0KwhCQjdTq..." } ], "notes": [], "offline_payments": [], "paypal_account": { "id": "mJVWkmzVz0i42j0GEVK4", "name": "My PayPal Account", "paypal_account_email": "myemail@gmail.com" }, "paypal_customer_id": null, "paypal_transaction_amount": 0.01, "paypal_transaction_date": "2019-07-02T15:46:58+00:00", "paypal_transaction_date_unix": 1562082418, "paypal_transaction_id": "XXXXXXXXXXXX", "pending_refunds": [ "vEn8K4MKavIRAyw0NVbR" ], "product_sales": [ "7rgo91jKVmtYk8NBnnNm" ], "sales": [ "MWymZv5d6bSpQLl1ARMm" ], "salvage_transactions": [], "shipping": [ "qZ4vKalGg5tv298VvO8V" ], "smtp_messages": [], "subscription_renewals": [], "subscriptions": [], "tax": [], "third_party_shop": { "id": "Q48aAbVv21fJRvNKWrvP", "name": "My Shop" }, "transactions": [], "trials": [], "updated_date_unix": 1562082510 } ], "total_count": 1, "total_pages": 1 }
Pending Refund
All credit card transactions, paypal transactions, checks and offline payments create a pending refund when refunded. RevCent automatically processes a pending refund once a credit card transaction has settled with the merchant gateway.
Pending Refund Process
Manually process a pending refund. This is not recommended, as RevCent will process pending refunds automatically. The response JSON is useful for notification events sent to endpoints.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
Response JSON Schema
The amount of the item.
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The RevCent ID of the campaign.
The name of the campaign associated with the item.
The result code for the request.
0 = RevCent Error
1 = Success
The RevCent ID of the customer.
The customer object.
The customers' first address line.
The customers' second address line.
Whether the customer has been blocked from purchases.
The customers' city.
The customers' company.
The customers' country.
The customers' email.
Whether the customer is currently enabled.
The customers' first name.
The customers' full address.
Whether the customers' address was successfully geocoded using the Google geocoding service.
The Google place ID for the customers' address using the Google geocoding service.
The RevCent ID for the customer.
Your internal ID for the customer.
The customers' last name.
The approximate latitude for the customers' address using the Google geocoding service.
The approximate longitude for the customers' address using the Google geocoding service.
The customers' phone number.
The customers' state.
The customers' state in long format.
The customers' status.
The customers' zip or postal code.
The raw response of the gateway request as a result of the refund if original payment was via Credit Card.
The ID of the transaction being refunded if original payment was via Credit Card.
The raw response of the PayPal request as a result of the refund if original payment was via PayPal.
The ID of the PayPal transaction the refunded if original payment was via PayPal.
The ID of the pending refund being processed.
The API request method.
The API request type.
The a brief description of the result of the API call.
The ID of the transaction created as a result of the refund if original payment was via Credit Card.
Request JSON
{ "request": { "type": "pending_refund", "method": "process", "id": "8rRNgQd0NGUv6Ggn7og0" } }
Response JSON
{ "amount": 9.35, "api_call_id": "wLRrX7jbJrI8R89jg8Bq", "api_call_unix": 1631302671, "campaign_id": "mJ1zZoOobEuP8pnWKXd1", "campaign_name": "Adwords Campaign", "code": 1, "customer": { "address_line_1": "1600 Pennsylvania Ave", "address_line_2": "", "blocked": false, "city": "Washington", "company": "", "country": "USA", "email": "georgew@whitehouse.com", "enabled": true, "first_name": "George", "full_address": "1600 Pennsylvania Ave NW, Washington, DC 20500, USA", "geocode_success": true, "google_place_id": "ChIJGVtI4by3t4kRr51d_Qm_x58", "id": "4r158EzJmmcVM69dNLkg", "internal_id": "pres_0001", "last_name": "Washington", "lat": "38.8976633", "lon": "-77.0365739", "metadata": [], "phone": "1234567890", "state": "DC", "state_long": "DC", "zip": "20500" }, "customer_id": "4r158EzJmmcVM69dNLkg", "gateway_raw_response": "", "origin_transaction_id": "2rRG9OBOjmf7pO8LV6Mq", "pending_refund_id": "8rRNgQd0NGUv6Ggn7og0", "request_method": "process", "request_type": "pending_refund", "result": "Pending refund processed successfully. Origin transaction refunded.", "transaction_id": "BvEPbYWrNBH9R9W1B95W" }
Pending Refund Retrieve
Retrieve current information on a single pending refund or multiple pending refunds.
Please view Pagination and Filters for details on retrieving multiple items.
Request JSON Schema
The main request object.
The type of request being made.
The method for the request type.
The RevCent ID of the item. Required if multiple property equals false or is not present.
Whether it is a multiple type request.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The number of result items contained in the current page.
The current page of result, same as requested page, default is page 1.
The API request method.
The API request type.
An array of objects, each object being a unique item.
The amount of the item.
The RevCent ID of the campaign.
The name of the campaign associated with the item.
An array containing check direct IDs related to the item.
The unix timestamp of when the item was created.
The customer object.
The customers' first address line.
The customers' second address line.
Whether the customer has been blocked from purchases.
The customers' city.
The customers' company.
The customers' country.
The customers' email.
Whether the customer is currently enabled.
The customers' first name.
The customers' full address.
Whether the customers' address was successfully geocoded using the Google geocoding service.
The Google place ID for the customers' address using the Google geocoding service.
The RevCent ID for the customer.
Your internal ID for the customer.
The customers' last name.
The approximate latitude for the customers' address using the Google geocoding service.
The approximate longitude for the customers' address using the Google geocoding service.
The customers' phone number.
The customers' state.
The customers' state in long format.
The customers' status.
The customers' zip or postal code.
An array containing discounts related to the item.
The RevCent ID of the gateway.
The name of the gateway.
The RevCent ID of the object item.
If the item was created using a check_direct payment method.
If the item was created using an offline payment method.
Whether the item was created using a live or test RevCent API key.
An array containing offline payment IDs related to the item.
The payment type related to the item.
The system ID of the payment type related to the item.
The system name of the payment type related to the item.
An array containing RevCent PayPal transaction IDs related to the item.
Whether the pending refund has been processed.
An array containing product sale IDs related to the item.
The credit card transaction ID being refunded.
An array containing sale IDs related to the item.
An array containing salvage transaction IDs related to the item.
An array containing shipping IDs related to the item.
An array containing SMTP message IDs related to the item.
The current status of the related item.
An array containing subscription renewal IDs related to the item.
An array containing subscription IDs related to the item.
The credit card refund transaction ID.
An array containing tax IDs related to the item.
An array containing trial IDs related to the item.
The unix timestamp of when the item was updated.
The total number of result items for the given request.
The total number of pages for the given request.
Request JSON
{ "request": { "type": "pending_refund", "method": "retrieve", "id": "MW5LoAVymnHww96XllEr" } }
Response JSON
{ "api_call_id": "bOBy95a444sy46EMwBj1", "api_call_processed": true, "api_call_unix": 1565814904, "code": 1, "current_count": 1, "current_page": 1, "request_method": "retrieve", "request_type": "pending_refund", "results": [ { "amount": 0.89, "campaign_id": "X849YQm7BEf0ZQd7Ol1K", "campaign_name": "Facebook Campaign", "check_directs": [], "created_date_unix": 1565814903, "customer": { "address_line_1": "1600 Pennsylvania Ave", "address_line_2": "", "blocked": false, "city": "Washington", "company": "", "country": "USA", "email": "georgew@whitehouse.com", "enabled": true, "first_name": "George", "full_address": "1600 Pennsylvania Ave NW, Washington, DC 20500, USA", "geocode_success": true, "google_place_id": "ChIJGVtI4by3t4kRr51d_Qm_x58", "id": "4r158EzJmmcVM69dNLkg", "internal_id": "pres_0001", "last_name": "Washington", "lat": "38.8976633", "lon": "-77.0365739", "metadata": [], "phone": "1234567890", "state": "DC", "state_long": "DC", "zip": "20500" }, "discounts": [], "gateway_id": "NkAMJOzpB5iEAOrdloV0", "gateway_name": "Braintree", "id": "MW5LoAVymnHww96XllEr", "is_check_direct": false, "is_offline_payment": false, "live_mode": false, "notes": [], "offline_payments": [], "payment_type": { "id": "KnQ0KlNE6kf5mobyV0pN", "name": "Credit Card" }, "paypal_transactions": [], "processed": false, "product_sales": [ "LY5yop5nk7hbPzpBn8aY" ], "refund_transaction_id": "ALRjyqRE27fjMonyKLny", "sales": [ "k6vnbJom00Ug89mpRj78" ], "salvage_transactions": [ "VPm9Mqmgw7UJJLldojJY" ], "shipping": [], "smtp_messages": [], "status": "Processing", "subscription_renewals": [], "subscriptions": [], "success_transaction_id": null, "tax": [], "trials": [], "updated_date_unix": 1565814903 } ], "total_count": 1, "total_pages": 1 }
Product
Create, edit, enable, disable and delete products using the RevCent API. Keep product details and other information up to date.
Product Create
Create a product via the product create method.
Important: RevCent will always create a new product. RevCent will not match sku, internal_id or other identifier to check for existing products in order to prevent duplicates. If you wish to modify a product that already exists in RevCent, use the Product > Edit method below.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The product object, containing the actual product and its attributes.
Product name.
Product description.
Product brand. For upcoming search engine integration.
If the product is enabled, i.e. available for purchase.
If the product is a child product of a parent product.
If the product is a child product, or variation, of a different product provide the RevCent ID for the parent product
If you wish to contain the product within one or more RevCent product groups. Provide the RevCent ID(s) of each product group.
Whether the product is a bundle consisting of individual bundled products. Read More
The bundle settings, specifying the bundled products and unbundle method. Bundled products total must equal product price. Read More
An array of individual products within the main bundle product.
The RevCent ID of the bundled product.
The quantity of the bundled product.
The price of the bundled product.
The unbundle method. Read More
- unbundle_at_fulfillment: When a sale request is received, the bundle product is not unbundled yet, and is instead processed as a single product.
- unbundle_at_sale: When a sale request is received, the bundle product is unbundled and replaced by each product contained in the bundle.
If the product is currently on sale. For upcoming search engine integration.
Product price. Default price to be charged upon purchase.
The product trial price. Price to charge when the trial ends, if different from initial sale price.
If the subscription renewal price is different from initial sale price
If the sale price if different from initial sale price and product is currently on sale. For upcoming search engine integration.
Current available stock. For upcoming search engine integration.
If the product is currently in stock. For upcoming search engine integration.
Product cost. For profit calculations.
Product MSRP. For upcoming search engine integration.
The rating value of the product. For upcoming search engine integration.
The total number of reviews. For upcoming search engine integration.
Product condition. For upcoming search engine integration.
An internal ID for the product. Can be used as an identifier for sale creation
Product SKU. Can be used as an identifier for sale creation.
Product URL.
Product UPC. For upcoming search engine integration.
Product EAN. For upcoming search engine integration.
Product ISBN. For upcoming search engine integration.
Product ASIN. For upcoming search engine integration.
Product MPN. For upcoming search engine integration.
The maximum allowed quantity of this product to be purchased in a single sale. 0 = No limit.
Trial duration in days. This will create a trial for the product and not charge the customer until the trial ends.
If this is a shippable product, specify when to ship the product. Accepted values:
- trial_expiration
- Product will only ship upon trial expiration.
- trial_creation
- Product will only ship when the trial is created.
- both_trial_expiration_creation
- Product will ship when trial is created and trial expiration.
If this is a subscription product, provide the ID of the subscription profile to use for recurring billing.
If the product is specific to a third party shop provide the ID of the third party shop.
If the product is a shippable product. A shipping entry will be created when the product is sold.
Shipping attributes specific to the product.
Product weight in lbs. For upcoming search engine and shipping cost integration.
Product length in inches. For upcoming search engine and shipping cost integration.
Product width in inches. For upcoming search engine and shipping cost integration.
Product height in inches. For upcoming search engine and shipping cost integration.
The fulfillment account for this product, if applicable.
Deprecated.
Additional custom IDs for the specific product as name value pairs. Useful when the same product is sold via multiple channels with a different ID for each channel.
A description of the ID, not used as the additional ID or identifier when creating a sale.
The actual additional ID, used to identify a specific product.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The RevCent ID of the product.
The API request method.
The API request type.
The a brief description of the result of the API call.
Request JSON
{ "request": { "type": "product", "method": "create", "product": { "name": "New Product", "description": "New product description.", "enabled": true, "sku": "new_product_sku", "url": "https://mystore.com/new-product-1", "internal_id": "new_product_internal_id", "price": 199.99, "price_trial": 199.99, "price_subscription": 199.99, "trial_shipping_setting": "both_trial_expiration_creation", "trial_days": 5, "is_shippable": true, "shipping_attributes": { "rate": "", "weight": "", "length": "", "width": "", "height": "", "fulfillment_account": "j0o25b2YJRFdJb8EEXE1" }, "additional_id": [ { "name": "another_id", "value": "id_123" } ], "subscription_profile": "d9NXVR62vGfYMw6VEZOl", "product_group": [ "EMYlAaXA1yfkWWora9rG" ], "third_party_shop": "2rgA7J9AN8CMEpaQGPqN", "is_bundle_product": true, "bundle_settings": { "products": [ { "id": "k6EXjKzd7PHOpgvdYjXG", "quantity": 1, "price": 100 }, { "id": "6r8O5MLbw2t6n4v1lGqK", "quantity": 1, "price": 99.99 } ], "unbundle_method": "unbundle_at_sale" } } } }
Response JSON
{ "api_call_id": "EMwJyj8bdEfX9YwmR2EW", "api_call_processed": true, "api_call_unix": 1565814920, "code": 1, "product_id": "qZBAz5nL0RfBgpgg2r49", "product_name": "New Product", "request_method": "create", "request_type": "product", "result": "Created new product." }
Product Edit
Edit an existing product in RevCent by providing the RevCent ID of the product via the product_id property. The product object is the same as in the Product > Create request.
Note: Only properties included in the edit request will be modified for the product within RevCent. For instance, if you only wanted to modify the price, simply include only the price property in the edit request product object.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The product ID
The product object, containing the actual product and its attributes.
Product name.
Product description.
Product brand. For upcoming search engine integration.
If the product is enabled, i.e. available for purchase.
If the product is a child product of a parent product.
If the product is a child product, or variation, of a different product provide the RevCent ID for the parent product
If you wish to contain the product within one or more RevCent product groups. Provide the RevCent ID(s) of each product group.
Whether the product is a bundle consisting of individual bundled products. Read More
The bundle settings, specifying the bundled products and unbundle method. Bundled products total must equal product price. Read More
An array of individual products within the main bundle product.
The RevCent ID of the bundled product.
The quantity of the bundled product.
The price of the bundled product.
The unbundle method. Read More
- unbundle_at_fulfillment: When a sale request is received, the bundle product is not unbundled yet, and is instead processed as a single product.
- unbundle_at_sale: When a sale request is received, the bundle product is unbundled and replaced by each product contained in the bundle.
If the product is currently on sale. For upcoming search engine integration.
Product price. Default price to be charged upon purchase.
The product trial price. Price to charge when the trial ends, if different from initial sale price.
If the subscription renewal price is different from initial sale price
If the sale price if different from initial sale price and product is currently on sale. For upcoming search engine integration.
Current available stock. For upcoming search engine integration.
If the product is currently in stock. For upcoming search engine integration.
Product cost. For profit calculations.
Product MSRP. For upcoming search engine integration.
The rating value of the product. For upcoming search engine integration.
The total number of reviews. For upcoming search engine integration.
Product condition. For upcoming search engine integration.
An internal ID for the product. Can be used as an identifier for sale creation
Product SKU. Can be used as an identifier for sale creation.
Product UPC. For upcoming search engine integration.
Product EAN. For upcoming search engine integration.
Product ISBN. For upcoming search engine integration.
Product ASIN. For upcoming search engine integration.
Product MPN. For upcoming search engine integration.
The maximum allowed quantity of this product to be purchased in a single sale. 0 = No limit.
Trial duration in days. This will create a trial for the product and not charge the customer until the trial ends.
If this is a shippable product, specify when to ship the product. Accepted values:
- trial_expiration
- Product will only ship upon trial expiration.
- trial_creation
- Product will only ship when the trial is created.
- both_trial_expiration_creation
- Product will ship when trial is created and trial expiration.
If this is a subscription product, provide the ID of the subscription profile to use for recurring billing.
If the product is specific to a third party shop provide the ID of the third party shop.
If the product is a shippable product. A shipping entry will be created when the product is sold.
Shipping attributes specific to the product.
Product weight in lbs. For upcoming search engine and shipping cost integration.
Product length in inches. For upcoming search engine and shipping cost integration.
Product width in inches. For upcoming search engine and shipping cost integration.
Product height in inches. For upcoming search engine and shipping cost integration.
The fulfillment account for this product, if applicable.
Deprecated.
Additional custom IDs for the specific product as name value pairs. Useful when the same product is sold via multiple channels with a different ID for each channel.
A description of the ID, not used as the additional ID or identifier when creating a sale.
The actual additional ID, used to identify a specific product.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The RevCent ID of the product.
The API request method.
The API request type.
The a brief description of the result of the API call.
Request JSON
{ "request": { "type": "product", "method": "edit", "product_id": "qZBAz5nL0RfBgpgg2r49", "product": { "max_quantity_allowed": 2, "subscription_profile": "d9NXVR62vGfYMw6VEZOl", "shipping_attributes": { "fulfillment_account": "j0o25b2YJRFdJb8EEXE1" }, "name": "My Awesome Product", "description": "My awesome product description", "url": "https://mystore.com/my-awesome-product", "price": 199.99, "price_trial": 199.99, "price_subscription": 199.99, "trial_shipping_setting": "both_trial_expiration_creation", "trial_days": 3, "enabled": true, "is_shippable": true, "is_bundle_product": true, "bundle_settings": { "products": [ { "id": "k6EXjKzd7PHOpgvdYjXG", "quantity": 1, "price": 100 }, { "id": "6r8O5MLbw2t6n4v1lGqK", "quantity": 1, "price": 99.99 } ], "unbundle_method": "unbundle_at_sale" } } } }
Response JSON
{ "api_call_id": "VPm9MqdqLzUJJ1GNdyqR", "api_call_processed": true, "api_call_unix": 1565814921, "code": 1, "product_id": "qZBAz5nL0RfBgpgg2r49", "request_method": "edit", "request_type": "product", "result": "Product successfully modified." }
Product Enable
Enable a product which has been previously disabled.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The product ID
Request JSON
{ "request": { "type": "product", "method": "enable", "product_id": "qZBAz5nL0RfBgpgg2r49" } }
Response JSON
{ "api_call_id": "ZVEGoylyMacZZ1XkLX1M", "api_call_processed": true, "api_call_unix": 1565814921, "code": 1, "product_id": "qZBAz5nL0RfBgpgg2r49", "request_method": "enable", "request_type": "product", "result": "Product successfully enabled." }
Product Disable
Disable a product, not allowing it to be included in a sale.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The product ID
Request JSON
{ "request": { "type": "product", "method": "disable", "product_id": "qZBAz5nL0RfBgpgg2r49" } }
Response JSON
{ "api_call_id": "YaVqjAdAG8tGGYALrzMg", "api_call_processed": true, "api_call_unix": 1565814921, "code": 1, "product_id": "qZBAz5nL0RfBgpgg2r49", "request_method": "disable", "request_type": "product", "result": "Product successfully disabled." }
Product Delete
Delete a product from RevCent. We highly recommend you do not use this method if the product has existing sales, subscriptions, etc. associate with it.
Request JSON Schema
The main request object
The type of request being made.
The method for the request type.
The product ID
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The RevCent ID of the product.
The API request method.
The API request type.
The a brief description of the result of the API call.
Request JSON
{ "request": { "type": "product", "method": "delete", "product_id": "qZBAz5nL0RfBgpgg2r49" } }
Response JSON
{ "api_call_id": "bOBy95E8awiypP4046jm", "api_call_processed": true, "api_call_unix": 1565814922, "code": 1, "product_id": "qZBAz5nL0RfBgpgg2r49", "request_method": "delete", "request_type": "product", "result": "Product successfully deleted." }
Product Retrieve
Retrieve current information on a single product or multiple products.
Please view Pagination and Filters for details on retrieving multiple items.
Request JSON Schema
The main request object.
The type of request being made.
The method for the request type.
The RevCent ID of the item. Required if multiple property equals false or is not present.
Whether it is a multiple type request.
Response JSON Schema
The API call ID of the request. Every API request is assigned an ID.
Indicates whether the API call was processed.
The unix timestamp of when the API call was made.
The result code for the request.
0 = RevCent Error
1 = Success
The number of result items contained in the current page.