{ "opencollection": "1.0.0", "info": { "name": "VTex Anti-fraud Provider Account Coupons API", "version": "1.0" }, "items": [ { "info": { "name": "Coupons", "type": "folder" }, "items": [ { "info": { "name": "VTex Get coupons", "type": "http" }, "http": { "method": "GET", "url": "https://{providerApiEndpoint}/api/rnb/v2/pvt/coupon", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "Accept", "value": "" } ] }, "docs": "Retrieves the list of all active coupons.\r\n\r\n## Permissions\r\n\r\nAny user or [application key](https://developers.vtex.com/docs/guides/api-authentication-using-application-keys) must have at least one of the appropriate [License Manager resources](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3) to be able to successfully run this request. Otherwise they will receive a status code `403` error. These are the applicable resources for this endpoint:\r\n\r\n| **Product*" }, { "info": { "name": "VTex Get archived coupons", "type": "http" }, "http": { "method": "GET", "url": "https://{providerApiEndpoint}/api/rnb/v2/pvt/coupon/group/archived", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "Accept", "value": "" } ] }, "docs": "Retrieves the list of all archived coupons.\r\n\r\n## Permissions\r\n\r\nAny user or [application key](https://developers.vtex.com/docs/guides/api-authentication-using-application-keys) must have at least one of the appropriate [License Manager resources](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3) to be able to successfully run this request. Otherwise they will receive a status code `403` error. These are the applicable resources for this endpoint:\r\n\r\n| **Produc" }, { "info": { "name": "VTex Get coupon batch information", "type": "http" }, "http": { "method": "GET", "url": "https://{providerApiEndpoint}/api/rnb/v2/pvt/coupon/group/:groupingKey", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "Accept", "value": "" } ], "params": [ { "name": "groupingKey", "value": "promo", "type": "path", "description": "Coupon grouping key, which is the prefix for the coupon batch's generated codes." } ] }, "docs": "Retrieves information from a specific coupon batch based on its `groupingKey`.\r\n\r\n## Permissions\r\n\r\nAny user or [application key](https://developers.vtex.com/docs/guides/api-authentication-using-application-keys) must have at least one of the appropriate [License Manager resources](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3) to be able to successfully run this request. Otherwise they will receive a status code `403` error. These are the applicable resourc" }, { "info": { "name": "VTex Edit coupon batch configuration", "type": "http" }, "http": { "method": "PUT", "url": "https://{providerApiEndpoint}/api/rnb/v2/pvt/coupon/group/:groupingKey", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "Accept", "value": "" } ], "params": [ { "name": "groupingKey", "value": "promo", "type": "path", "description": "Coupon grouping key, which is the prefix for the coupon batch's generated codes." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Changes information from a specific coupon batch configuration based on its `groupingKey`.\r\n\r\n## Permissions\r\n\r\nAny user or [application key](https://developers.vtex.com/docs/guides/api-authentication-using-application-keys) must have at least one of the appropriate [License Manager resources](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3) to be able to successfully run this request. Otherwise they will receive a status code `403` error. These are the applic" }, { "info": { "name": "VTex Get coupon batch codes", "type": "http" }, "http": { "method": "GET", "url": "https://{providerApiEndpoint}/api/rnb/v2/pvt/coupon/group/:groupingKey/codes", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "Accept", "value": "" } ], "params": [ { "name": "groupingKey", "value": "promo", "type": "path", "description": "Coupon grouping key, which is the prefix for the coupon batch's generated codes." } ] }, "docs": "Retrieves a specific coupon batch's list of codes.\r\n\r\n## Permissions\r\n\r\nAny user or [application key](https://developers.vtex.com/docs/guides/api-authentication-using-application-keys) must have at least one of the appropriate [License Manager resources](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3) to be able to successfully run this request. Otherwise they will receive a status code `403` error. These are the applicable resources for this endpoint:\r\n\r\n| *" }, { "info": { "name": "VTex Archive a coupon batch", "type": "http" }, "http": { "method": "PUT", "url": "https://{providerApiEndpoint}/api/rnb/v2/pvt/coupon/group/:groupingKey/archive", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "Accept", "value": "" } ], "params": [ { "name": "groupingKey", "value": "promo", "type": "path", "description": "Coupon grouping key, which is the prefix for the coupon batch's generated codes." } ] }, "docs": "Archives a coupon batch and its respective codes.\r\n\r\n## Permissions\r\n\r\nAny user or [application key](https://developers.vtex.com/docs/guides/api-authentication-using-application-keys) must have at least one of the appropriate [License Manager resources](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3) to be able to successfully run this request. Otherwise they will receive a status code `403` error. These are the applicable resources for this endpoint:\r\n\r\n| **" }, { "info": { "name": "VTex Create coupon batches", "type": "http" }, "http": { "method": "POST", "url": "https://{providerApiEndpoint}/api/rnb/v2/pvt/coupon/group", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "Accept", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Creates one or more coupon batches.\r\n\r\n## Permissions\r\n\r\nAny user or [application key](https://developers.vtex.com/docs/guides/api-authentication-using-application-keys) must have at least one of the appropriate [License Manager resources](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3) to be able to successfully run this request. Otherwise they will receive a status code `403` error. These are the applicable resources for this endpoint:\r\n\r\n| **Product** | **" }, { "info": { "name": "VTex Unarchive a coupon batch", "type": "http" }, "http": { "method": "PUT", "url": "https://{providerApiEndpoint}/api/rnb/v2/pvt/coupon/group/:groupingKey/unarchive", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "Accept", "value": "" } ], "params": [ { "name": "groupingKey", "value": "promo", "type": "path", "description": "Coupon grouping key, which is the prefix for the coupon batch's generated codes." } ] }, "docs": "Unarchives a coupon batch and its respective codes.\r\n\r\n## Permissions\r\n\r\nAny user or [application key](https://developers.vtex.com/docs/guides/api-authentication-using-application-keys) must have at least one of the appropriate [License Manager resources](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3) to be able to successfully run this request. Otherwise they will receive a status code `403` error. These are the applicable resources for this endpoint:\r\n\r\n| " }, { "info": { "name": "VTex Get usage count for a single coupon", "type": "http" }, "http": { "method": "GET", "url": "https://{providerApiEndpoint}/api/rnb/v2/pvt/coupon/usage-count/:couponCode", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "Accept", "value": "" } ], "params": [ { "name": "couponCode", "value": "blackfriday10", "type": "path", "description": "Single coupon code." } ] }, "docs": "Returns the number of times a specific single coupon was used, based on its `couponCode`.\r\n\r\n## Permissions\r\n\r\nAny user or [application key](https://developers.vtex.com/docs/guides/api-authentication-using-application-keys) must have at least one of the appropriate [License Manager resources](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3) to be able to successfully run this request. Otherwise they will receive a status code `403` error. These are the applica" }, { "info": { "name": "VTex Get usage count for a coupon batch", "type": "http" }, "http": { "method": "GET", "url": "https://{providerApiEndpoint}/api/rnb/v2/pvt/coupon/usage-count/group/:groupingKey", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "Accept", "value": "" } ], "params": [ { "name": "groupingKey", "value": "rewardsprogram", "type": "path", "description": "Coupon grouping key, which is the prefix for the coupon batch's generated codes." } ] }, "docs": "Returns the number of times a coupon batch was used, based on its `groupingKey`.\r\n\r\n## Permissions\r\n\r\nAny user or [application key](https://developers.vtex.com/docs/guides/api-authentication-using-application-keys) must have at least one of the appropriate [License Manager resources](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3) to be able to successfully run this request. Otherwise they will receive a status code `403` error. These are the applicable resou" } ] } ], "bundled": true }