{"id":"57336fd5a6a9c40e00e13a0b","name":"Developer Hub","subdomain":"bluesnap-developers","versions":[{"_id":"5b196f345952df0003e8a66c","releaseDate":"2018-04-24T15:22:41.561Z","is_deprecated":false,"is_hidden":true,"is_beta":false,"is_stable":false,"codename":"3.26 Release","version_clean":"2.1.16","version":"2.1.16"},{"_id":"5b1972b45952df0003e8a725","releaseDate":"2018-04-23T14:36:48.535Z","is_deprecated":false,"is_hidden":true,"is_beta":false,"is_stable":false,"codename":"3.26 Release","version_clean":"1.0.17","version":"1.0.17"},{"_id":"5b1973ec0059c20003083ec0","releaseDate":"2018-04-24T15:24:22.608Z","is_deprecated":false,"is_hidden":true,"is_beta":false,"is_stable":false,"codename":"3.26 Release","version_clean":"2.0.18","version":"2.0.18"},{"_id":"5b19742cb3baf90003cab5ae","releaseDate":"2018-04-24T15:33:45.744Z","is_deprecated":false,"is_hidden":true,"is_beta":false,"is_stable":false,"codename":"3.26 Release","version_clean":"3.0.16","version":"3.0.16"},{"_id":"5b197473be7bb50003d5dbd6","releaseDate":"2018-04-23T15:17:35.680Z","is_deprecated":false,"is_hidden":true,"is_beta":false,"is_stable":false,"codename":"3.26 Release","version_clean":"4.0.18","version":"4.0.18"},{"_id":"5b8ec56484303f0003a1145f","releaseDate":"2018-04-23T14:36:48.535Z","is_deprecated":false,"is_hidden":true,"is_beta":false,"is_stable":false,"codename":"3.27 Release","version_clean":"1.0.18","version":"1.0.18"},{"_id":"5b8ec5e884303f0003a114fb","releaseDate":"2018-04-24T15:22:41.561Z","is_deprecated":false,"is_hidden":true,"is_beta":false,"is_stable":false,"codename":"3.27 Release","version_clean":"2.1.17","version":"2.1.17"},{"_id":"5b8ec61584303f0003a1159b","releaseDate":"2018-04-24T15:24:22.608Z","is_deprecated":false,"is_hidden":true,"is_beta":false,"is_stable":false,"codename":"3.27 Release","version_clean":"2.0.19","version":"2.0.19"},{"_id":"5b8ec64c7ef0f4000350182a","releaseDate":"2018-04-23T15:17:35.680Z","is_deprecated":false,"is_hidden":true,"is_beta":false,"is_stable":false,"codename":"3.27 Release","version_clean":"4.0.19","version":"4.0.19"},{"_id":"5b8ec6a1f8dd7c0003386069","releaseDate":"2018-04-24T15:33:45.744Z","is_deprecated":false,"is_hidden":true,"is_beta":false,"is_stable":false,"codename":"3.27 Release","version_clean":"3.0.17","version":"3.0.17"},{"_id":"5bbf93937ef195000329c63e","releaseDate":"2018-04-23T14:36:48.535Z","is_deprecated":false,"is_hidden":true,"is_beta":false,"is_stable":false,"codename":"3.27.4 Release","version_clean":"1.0.19","version":"1.0.19"},{"_id":"5bc48b4f9919d4000df5ea7b","releaseDate":"2018-04-23T15:17:35.680Z","is_deprecated":false,"is_hidden":true,"is_beta":false,"is_stable":false,"codename":"3.27.4 Release","version_clean":"4.0.20","version":"4.0.20"},{"_id":"5bcf36ac4eaaa605217d94b8","releaseDate":"2018-04-24T15:22:41.561Z","is_deprecated":false,"is_hidden":true,"is_beta":false,"is_stable":false,"codename":"3.27.4 Release","version_clean":"2.1.18","version":"2.1.18"},{"_id":"5bcf37dfadc5b905136a39f4","releaseDate":"2018-04-24T15:24:22.608Z","is_deprecated":false,"is_hidden":true,"is_beta":false,"is_stable":false,"codename":"3.27.4 Release","version_clean":"2.0.20","version":"2.0.20"},{"_id":"5bcf3922e8455d049c357ed7","releaseDate":"2018-04-24T15:33:45.744Z","is_deprecated":false,"is_hidden":true,"is_beta":false,"is_stable":false,"codename":"3.27.4 Release","version_clean":"3.0.18","version":"3.0.18"},{"_id":"5bdc633c15437b0042ed963c","releaseDate":"2018-04-23T15:17:35.680Z","is_deprecated":false,"is_hidden":true,"is_beta":false,"is_stable":false,"codename":"3.29 Release","version_clean":"4.0.21","version":"4.0.21"},{"_id":"5beb278ac442ab0213f009cf","releaseDate":"2018-04-23T14:36:48.535Z","is_deprecated":false,"is_hidden":true,"is_beta":false,"is_stable":false,"codename":"3.28 Release","version_clean":"1.0.20","version":"1.0.20"},{"_id":"5bedbcf19b49e8004462d199","releaseDate":"2018-04-24T15:33:45.744Z","is_deprecated":false,"is_hidden":true,"is_beta":false,"is_stable":false,"codename":"3.29 Release","version_clean":"3.0.19","version":"3.0.19"},{"_id":"5bedd214812951004a2ad9df","releaseDate":"2018-04-24T15:22:41.561Z","is_deprecated":false,"is_hidden":true,"is_beta":false,"is_stable":false,"codename":"3.29 Release","version_clean":"2.1.19","version":"2.1.19"},{"_id":"5beec5a5f95d82011c6f3714","releaseDate":"2018-04-24T15:24:22.608Z","is_deprecated":false,"is_hidden":true,"is_beta":false,"is_stable":false,"codename":"3.29 Release","version_clean":"2.0.21","version":"2.0.21"},{"_id":"5c6c238ff7d54800395355a0","releaseDate":"2018-04-23T14:36:48.535Z","is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"Main","version_clean":"8976.0.0-Basics","version":"8976-Basics"},{"_id":"5c6c23e4735b81006177d0a4","releaseDate":"2018-04-24T15:22:41.561Z","is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":false,"codename":"Main","version_clean":"8976.0.0-JSON","version":"8976-JSON"},{"_id":"5c6c2407b8d4b2000e72da25","releaseDate":"2018-04-24T15:24:22.608Z","is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":false,"codename":"Main","version_clean":"8976.0.0-XML","version":"8976-XML"},{"_id":"5c6c245bc0d91f0185a7409c","releaseDate":"2018-04-23T15:17:35.680Z","is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":false,"codename":"Main","version_clean":"8976.0.0-Tools","version":"8976-Tools"},{"_id":"5c742637ad58c70033b9c762","releaseDate":"2018-04-24T15:33:45.744Z","is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":false,"codename":"Main","version_clean":"8976.0.0-Extended","version":"8976-Extended"}],"current_version":{"version_clean":"8976.0.0-XML","version":"8976-XML"},"oauth":{"enabled":false},"api":{"name":"","url":"https://sandbox.bluesnap.com/services/2","contenttype":"body","auth":"basic","explorer":true,"proxyEnabled":true,"jwt":false,"authextra":[{"_id":"561b9fceab412a0d004d8631","type":"header","default":"Basic QVBJXzE0NDQ2NTAyMDMxNDQ5NDA0MjIzNjU6QkxVRTEyMw==","key":"Authorization"}],"headers":[{"_id":"561c03a2eaf4852b00a46771","value":"Application/XML","key":"content-type"},{"_id":"56f12a866d8030220001ef98","value":"2.0","key":"bluesnap-version"}],"object_definitions":[]},"apiAlt":[{"_id":"57ee593a21ceb20e0061959e","object_definitions":[],"headers":[{"_id":"57ee59b33b369f0e00469e40","value":"application/json","key":"content-type"},{"_id":"57ee59b33b369f0e00469e3f","value":"application/json","key":"accept"},{"_id":"57ee672b21ceb20e006195a4","value":"2.0","key":"bluesnap-version"}],"authextra":[{"_id":"57ee59b33b369f0e00469e3e","type":"header","default":"Basic QVBJXzE0NDQ2NTAyMDMxNDQ5NDA0MjIzNjU6QkxVRTEyMw==","key":"Authorization"}],"jwt":false,"proxyEnabled":true,"explorer":true,"auth":"basic","contenttype":"body","url":"https://sandbox.bluesnap.com/services/2","name":"JSON"}],"plan_details":{"name":"Business","is_active":true,"cost":199,"versions":10000,"custom_domain":true,"custom_pages":true,"whitelabel":true,"errors":true,"password":true,"landing_page":true,"stylesheet":true,"javascript":true,"html":true,"extra_html":true,"admins":true},"intercom":"","intercom_secure_emailonly":false,"flags":{"allow_hub2":false,"hub2":false,"migrationRun":true,"oauth":false,"swagger":false,"correctnewlines":false,"speedyRender":true,"allowXFrame":false,"jwt":false,"hideGoogleAnalytics":false,"stripe":false,"disableDiscuss":false,"newApiExplorer":false},"asset_base_url":""}

{"_id":"5c6c2407b8d4b2000e72d9b3","category":{"_id":"5c6c2407b8d4b2000e72d98d","version":"5c6c2407b8d4b2000e72da25","project":"57336fd5a6a9c40e00e13a0b","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-10-15T16:20:51.519Z","from_sync":false,"order":12,"slug":"resources","title":"Resources"},"project":"57336fd5a6a9c40e00e13a0b","user":"560d5913af97231900938124","parentDoc":null,"version":{"_id":"5c6c2407b8d4b2000e72da25","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"5beec5a5f95d82011c6f3714","createdAt":"2018-04-24T15:24:22.608Z","releaseDate":"2018-04-24T15:24:22.608Z","categories":["5c6c2407b8d4b2000e72d981","5c6c2407b8d4b2000e72d982","5c6c2407b8d4b2000e72d983","5c6c2407b8d4b2000e72d984","5c6c2407b8d4b2000e72d985","5c6c2407b8d4b2000e72d986","5c6c2407b8d4b2000e72d987","5c6c2407b8d4b2000e72d988","5c6c2407b8d4b2000e72d989","5c6c2407b8d4b2000e72d98a","5c6c2407b8d4b2000e72d98b","5c6c2407b8d4b2000e72d98c","5c6c2407b8d4b2000e72d98d","5c6c2407b8d4b2000e72d98e","5c6c2407b8d4b2000e72d98f","5c6c2407b8d4b2000e72d990"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":false,"codename":"Main","version_clean":"8976.0.0-XML","version":"8976-XML"},"githubsync":"","__v":0,"metadata":{"title":"","description":"","image":[]},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-01-06T17:57:36.225Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":31,"body":"###Request\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Property Name\",\n    \"h-1\": \"Type\",\n    \"h-2\": \"Required\",\n    \"0-0\": \"`transaction-type`\",\n    \"0-1\": \"*string*\",\n    \"h-3\": \"Description\",\n    \"0-3\": \"Defines the action that will occur in the transaction request.\\n`AUTH_CAPTURE`\\n`AUTH_ONLY`\\n`CAPTURE`\\n`SET_ORDER`\\n`DO_ORDER`\",\n    \"3-0\": \"`req-confirm-shipping`\",\n    \"3-2\": \"Optional\",\n    \"3-3\": \"Determines whether the buyer's shipping address on file with PayPal must be a confirmed address. \\n\\nValues can be:\\n  * **0**: Does not have to be a confirmed address.\\n  * **1**: Must be a confirmed address.\",\n    \"3-1\": \"*integer*\",\n    \"2-0\": \"`cancel-url`\",\n    \"2-1\": \"*string*\",\n    \"2-3\": \"URL where the shopper will be redirected if cancelling the PayPal purchase, up to 1000 characters.\",\n    \"0-2\": \"**Required** for two-step and three step flow.\\n\\n**Optional** for standard redirect flow\",\n    \"2-2\": \"**Required**\\n*only for transactions that are not recurring*\",\n    \"4-0\": \"`no-shipping`\",\n    \"4-1\": \"*integer*\",\n    \"4-2\": \"Optional\",\n    \"4-3\": \"Determines whether PayPal displays shipping address fields on the PayPal pages. \\n\\nValues can be:\\n  * **0**: PayPal displays the shipping address fields.\\n  * **1**: PayPal does not display the shipping address fields.\\n  * **2**: If you do not pass the shipping address, PayPal obtains it from the shopper's account profile.\",\n    \"5-0\": \"`in-context`\",\n    \"5-1\": \"*boolean*\",\n    \"5-2\": \"Optional\",\n    \"5-3\": \"Set value to **true** in order to use In-Context PayPal checkout.\\nWhen set to true, PayPal will return a URL for In-Context checkout.\\nFor more information, see [The shopper experience with PayPal (Express checkout vs In-Context checkout)](/docs/paypal#section-the-shopper-experience-with-paypal-express-checkout-vs-in-context-checkout-).\",\n    \"6-0\": \"`recurring`\",\n    \"7-0\": \"`paypal-subscription-id`\",\n    \"6-1\": \"*string*\",\n    \"7-1\": \"*string*\",\n    \"6-2\": \"Optional\",\n    \"7-2\": \"Optional\",\n    \"6-3\": \"If this is the initial payment for a subscription, include this property and set the value to **1**.\",\n    \"7-3\": \"ID of the PayPal subscription associated with this transaction.\\n\\nWhen processing recurring payments for a subscription, include this property in order to associate the payments with the relevant subscription. \\nFor more information, see the [guide to processing merchant-managed PayPal subscriptions](doc:subscription-management#section-processing-merchant-managed-paypal-subscription-payments).\",\n    \"1-0\": \"`return-url`\",\n    \"1-1\": \"*string*\",\n    \"1-2\": \"**Required**\\n*only for transactions that are not recurring*\",\n    \"1-3\": \"URL where the shopper will be redirected upon completing the PayPal purchase, up to 1000 characters.\"\n  },\n  \"cols\": 4,\n  \"rows\": 8\n}\n[/block]\n###Response\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Property Name\",\n    \"h-1\": \"Type\",\n    \"h-2\": \"Description\",\n    \"0-0\": \"`paypal-url`\",\n    \"0-1\": \"*integer*\",\n    \"1-0\": \"`order-id`\",\n    \"1-1\": \"*integer*\",\n    \"0-2\": \"URL to redirect the shopper to the purchase page in PayPal.\",\n    \"1-2\": \"Order ID used to retrieve transaction before the purchase has been completed, when there is not yet a transaction ID.\",\n    \"2-2\": \"Indicates whether [In-Context PayPal checkout](/docs/paypal#section-what-is-in-context-checkout-) is used. If so, PayPal returns a URL for In-Context checkout.\",\n    \"2-1\": \"*boolean*\",\n    \"2-0\": \"`in-context`\",\n    \"3-2\": \"ID of the PayPal subscription associated with this transaction.\",\n    \"3-1\": \"*string*\",\n    \"3-0\": \"`paypal-subscription-id`\"\n  },\n  \"cols\": 3,\n  \"rows\": 4\n}\n[/block]","excerpt":"Contains information required to process a PayPal transaction","slug":"paypal-transaction","type":"basic","title":"paypal-transaction"}

paypal-transaction

Contains information required to process a PayPal transaction

Request

Property Name

Type

Required

Description

transaction-type

string

Required for two-step and three step flow.

Optional for standard redirect flow

Defines the action that will occur in the transaction request.
AUTH_CAPTURE
AUTH_ONLY
CAPTURE
SET_ORDER
DO_ORDER

return-url

string

Required
only for transactions that are not recurring

URL where the shopper will be redirected upon completing the PayPal purchase, up to 1000 characters.

cancel-url

string

Required
only for transactions that are not recurring

URL where the shopper will be redirected if cancelling the PayPal purchase, up to 1000 characters.

req-confirm-shipping

integer

Optional

Determines whether the buyer's shipping address on file with PayPal must be a confirmed address.

Values can be:

0: Does not have to be a confirmed address.
1: Must be a confirmed address.

no-shipping

integer

Optional

Determines whether PayPal displays shipping address fields on the PayPal pages.

Values can be:

0: PayPal displays the shipping address fields.
1: PayPal does not display the shipping address fields.
2: If you do not pass the shipping address, PayPal obtains it from the shopper's account profile.

in-context

boolean

Optional

Set value to true in order to use In-Context PayPal checkout.
When set to true, PayPal will return a URL for In-Context checkout.
For more information, see The shopper experience with PayPal (Express checkout vs In-Context checkout).

recurring

string

Optional

If this is the initial payment for a subscription, include this property and set the value to 1.

paypal-subscription-id

string

Optional

ID of the PayPal subscription associated with this transaction.

When processing recurring payments for a subscription, include this property in order to associate the payments with the relevant subscription.
For more information, see the guide to processing merchant-managed PayPal subscriptions.

Response

Property Name

Type

Description

paypal-url

integer

URL to redirect the shopper to the purchase page in PayPal.

order-id

integer

Order ID used to retrieve transaction before the purchase has been completed, when there is not yet a transaction ID.

in-context

boolean

Indicates whether In-Context PayPal checkout is used. If so, PayPal returns a URL for In-Context checkout.

paypal-subscription-id

string

ID of the PayPal subscription associated with this transaction.