{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"optional","examples":{"codes":[]},"method":"get","results":{"codes":[]},"settings":"","params":[]},"next":{"description":"","pages":[]},"title":"Retrieve Coupon","type":"endpoint","slug":"retrieve-coupon","excerpt":"","body":"##Definition\nhttps<span>://sandbox.bluesnap.com/services/2/coupons/:coupon-id</span>\nhttps<span>://sandbox.bluesnap.com/services/2/coupons/resolve?couponcode=:couponcode</span>\n\n<hr>\n\n##Documentation\nThe Retrieve Coupon request enables you to retrieve details of an existing coupon. You can retrieve it based either on the coupon ID or the coupon code.\n\n###Request Content\n**Retrieve based on coupon ID**\nEnter the `shopper-id` into the web service URL, in the format:\n`services/2/coupons/{coupon-id}`\n\nFor example:\n`services/2/coupons/149920`\n\n**Retrieve based on coupon code**\nEnter the coupon code into the web service URL, in the format:\n`services/2/coupons/resolve?couponcode={couponcode}`\n\nFor example:\n`services/2/coupons/resolve?couponcode=50off`\n\n###Response Details\nIf successful, the response HTTP status code is 200 OK.\nThe response contains the retrieved `coupon-info` resource.\nFor details about possible errors, see: [General Errors](doc:general-errors) and [Catalog Errors](doc:catalog-errors).\n\n<hr>\n\n##Examples\n\n###Request Examples\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl -v -X GET https://sandbox.bluesnap.com/services/2/coupons/149920 \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='\",\n      \"language\": \"curl\",\n      \"name\": \"Retrieve Coupon Request: by coupon ID\"\n    },\n    {\n      \"code\": \"curl -v -X GET https://sandbox.bluesnap.com/services/2/coupons/resolve?couponcode=testcode2 \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='\",\n      \"language\": \"curl\",\n      \"name\": \"by coupon code\"\n    }\n  ]\n}\n[/block]\n###Response Examples\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\"?>\\n<coupon-info xmlns=\\\"http://ws.plimus.com\\\">\\n  <coupon-id>149920</coupon-id>\\n  <product-owner-id>397248</product-owner-id>\\n  <coupon-name>test-coupon</coupon-name>\\n  <coupon-display-name>test-coupon</coupon-display-name>\\n  <minimal-amount>0</minimal-amount>\\n  <usage-count-limit>99999</usage-count-limit>\\n  <coupon-effective-date>29-Jun-17</coupon-effective-date>\\n  <one-per-email>false</one-per-email>\\n  <apply-recurring-charges>false</apply-recurring-charges>\\n  <coupon-discount-policy>\\n    <coupon-discount-type>PRICE</coupon-discount-type>\\n    <coupon-price>\\n      <price-discounts>\\n        <price-discount>\\n          <currency>USD</currency>\\n          <amount>20.00</amount>\\n        </price-discount>\\n      </price-discounts>\\n    </coupon-price>\\n  </coupon-discount-policy>\\n  <coupon-rules>\\n    <applied-skus-rule>INCLUDE_All</applied-skus-rule>\\n  </coupon-rules>\\n  <coupon-codes-info>\\n    <coupon-code-info>\\n      <coupon-code>testcode</coupon-code>\\n      <coupon-code-usage>2</coupon-code-usage>\\n    </coupon-code-info>\\n  </coupon-codes-info>\\n</coupon-info>\",\n      \"language\": \"xml\",\n      \"name\": \"Retrieve Coupon Response: by coupon ID\"\n    },\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\"?>\\n<coupon-info xmlns=\\\"http://ws.plimus.com\\\">\\n  <coupon-id>150400</coupon-id>\\n  <product-owner-id>397248</product-owner-id>\\n  <coupon-name>test-coupon2</coupon-name>\\n  <coupon-display-name>test-coupon2</coupon-display-name>\\n  <minimal-amount>10</minimal-amount>\\n  <usage-count-limit>99999</usage-count-limit>\\n  <coupon-effective-date>11-Aug-17</coupon-effective-date>\\n  <one-per-email>true</one-per-email>\\n  <apply-recurring-charges>false</apply-recurring-charges>\\n  <coupon-discount-policy>\\n    <coupon-discount-type>PERCENT</coupon-discount-type>\\n    <coupon-percent>\\n      <percent-discount>20</percent-discount>\\n    </coupon-percent>\\n  </coupon-discount-policy>\\n  <coupon-rules>\\n    <applied-skus-rule>EXCLUDE_ALL</applied-skus-rule>\\n    <coupon-exceptions>\\n      <sku-id>2180434</sku-id>\\n    </coupon-exceptions>\\n  </coupon-rules>\\n  <coupon-codes-info>\\n    <coupon-code-info>\\n      <coupon-code>testcode2</coupon-code>\\n      <coupon-code-usage>0</coupon-code-usage>\\n    </coupon-code-info>\\n  </coupon-codes-info>\\n</coupon-info>\",\n      \"language\": \"xml\",\n      \"name\": \"by coupon code\"\n    }\n  ]\n}\n[/block]\n<br>\n<a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>","updates":[],"order":10,"isReference":true,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"61a5033cd3c4d201e7b583d8","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Catalog","slug":"coupon","order":4,"from_sync":false,"reference":true,"_id":"61a5033cd3c4d201e7b583be","version":"61a5033cd3c4d201e7b5848b","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2016-05-12T15:22:00.041Z","__v":0},"parentDoc":null,"user":"560d5913af97231900938124","project":"57336fd5a6a9c40e00e13a0b","version":{"version":"8976-Extended","version_clean":"8976.0.0-Extended","codename":"3.40 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["61a5033cd3c4d201e7b583ba","61a5033cd3c4d201e7b583bb","61a5033cd3c4d201e7b583bc","61a5033cd3c4d201e7b583bd","61a5033cd3c4d201e7b583be","61a5033cd3c4d201e7b583bf","61a5033cd3c4d201e7b583c0","61a5033cd3c4d201e7b583c1","61a5033cd3c4d201e7b583c2","61a5033cd3c4d201e7b583c3","61a5033cd3c4d201e7b583c4"],"_id":"61a5033cd3c4d201e7b5848b","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"6040037678d626005641a154","createdAt":"2018-04-24T15:33:45.744Z","releaseDate":"2018-04-24T15:33:45.744Z"},"createdAt":"2016-05-12T15:22:40.970Z","githubsync":"","__v":0}

Extended Payment API

Orders

Shopping Context

Shoppers

Catalog

Subscriptions

Wallets

Errors

Resources

Test Data & Codes

Guides & Tools

getRetrieve Coupon

Definition

https://sandbox.bluesnap.com/services/2/coupons/:coupon-id
https://sandbox.bluesnap.com/services/2/coupons/resolve?couponcode=:couponcode

Documentation

The Retrieve Coupon request enables you to retrieve details of an existing coupon. You can retrieve it based either on the coupon ID or the coupon code.

Request Content

Retrieve based on coupon ID
Enter the shopper-id into the web service URL, in the format:
services/2/coupons/{coupon-id}

For example:
services/2/coupons/149920

Retrieve based on coupon code
Enter the coupon code into the web service URL, in the format:
services/2/coupons/resolve?couponcode={couponcode}

For example:
services/2/coupons/resolve?couponcode=50off

Response Details

If successful, the response HTTP status code is 200 OK.
The response contains the retrieved coupon-info resource.
For details about possible errors, see: General Errors and Catalog Errors.

Examples

Request Examples

Retrieve Coupon Request: by coupon ID
by coupon code
curl -v -X GET https://sandbox.bluesnap.com/services/2/coupons/149920 \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='
curl -v -X GET https://sandbox.bluesnap.com/services/2/coupons/resolve?couponcode=testcode2 \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='

Response Examples

Retrieve Coupon Response: by coupon ID
by coupon code
<?xml version="1.0" encoding="UTF-8"?>
<coupon-info xmlns="http://ws.plimus.com">
  <coupon-id>149920</coupon-id>
  <product-owner-id>397248</product-owner-id>
  <coupon-name>test-coupon</coupon-name>
  <coupon-display-name>test-coupon</coupon-display-name>
  <minimal-amount>0</minimal-amount>
  <usage-count-limit>99999</usage-count-limit>
  <coupon-effective-date>29-Jun-17</coupon-effective-date>
  <one-per-email>false</one-per-email>
  <apply-recurring-charges>false</apply-recurring-charges>
  <coupon-discount-policy>
    <coupon-discount-type>PRICE</coupon-discount-type>
    <coupon-price>
      <price-discounts>
        <price-discount>
          <currency>USD</currency>
          <amount>20.00</amount>
        </price-discount>
      </price-discounts>
    </coupon-price>
  </coupon-discount-policy>
  <coupon-rules>
    <applied-skus-rule>INCLUDE_All</applied-skus-rule>
  </coupon-rules>
  <coupon-codes-info>
    <coupon-code-info>
      <coupon-code>testcode</coupon-code>
      <coupon-code-usage>2</coupon-code-usage>
    </coupon-code-info>
  </coupon-codes-info>
</coupon-info>
<?xml version="1.0" encoding="UTF-8"?>
<coupon-info xmlns="http://ws.plimus.com">
  <coupon-id>150400</coupon-id>
  <product-owner-id>397248</product-owner-id>
  <coupon-name>test-coupon2</coupon-name>
  <coupon-display-name>test-coupon2</coupon-display-name>
  <minimal-amount>10</minimal-amount>
  <usage-count-limit>99999</usage-count-limit>
  <coupon-effective-date>11-Aug-17</coupon-effective-date>
  <one-per-email>true</one-per-email>
  <apply-recurring-charges>false</apply-recurring-charges>
  <coupon-discount-policy>
    <coupon-discount-type>PERCENT</coupon-discount-type>
    <coupon-percent>
      <percent-discount>20</percent-discount>
    </coupon-percent>
  </coupon-discount-policy>
  <coupon-rules>
    <applied-skus-rule>EXCLUDE_ALL</applied-skus-rule>
    <coupon-exceptions>
      <sku-id>2180434</sku-id>
    </coupon-exceptions>
  </coupon-rules>
  <coupon-codes-info>
    <coupon-code-info>
      <coupon-code>testcode2</coupon-code>
      <coupon-code-usage>0</coupon-code-usage>
    </coupon-code-info>
  </coupon-codes-info>
</coupon-info>