{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","settings":"","results":{"codes":[]},"params":[]},"next":{"description":"","pages":[]},"title":"refund","type":"basic","slug":"refund-1","excerpt":"Contains refund details","body":"###Request\n[block:parameters]\n{\n \"data\": {\n \"h-0\": \"Property Name\",\n \"h-1\": \"Type\",\n \"h-2\": \"Required\",\n \"h-3\": \"Description\",\n \"0-0\": \"`amount`\",\n \"0-1\": \"*decimal*\",\n \"0-2\": \"Optional\",\n \"0-3\": \"Amount to be refunded, if this is a partial refund.\\n\\nValue must be greater than 0 and must not exceed the total transaction amount.\",\n \"2-0\": \"`reason`\",\n \"2-1\": \"*string*\",\n \"2-2\": \"Optional\",\n \"2-3\": \"Reason the shopper cancelled or requested a refund for the order. \\n\\nDefault value is \\\"Per your instructions\\\". \\n\\nMaximum 4000 characters.\",\n \"3-0\": \"`cancelSubscriptions`\",\n \"3-1\": \"*boolean*\",\n \"3-2\": \"Optional\",\n \"3-3\": \"Whether to cancel the subscription associated with the transaction ID. \\n\\nValues: \\n**true** (default) - Cancel the subscription and refund the charge\\n**false** - Do not cancel the subscription. Just refund the charge.\",\n \"4-0\": \"`vendorsRefundInfo`\",\n \"4-1\": \"*object*\",\n \"4-2\": \"Optional\",\n \"4-3\": \"Only applicable to partial refunds (if `amount` was passed). Contains the details about the Marketplace vendors' portion of the refund. \\n\\nSee [vendorsRefundInfo](doc:vendorsrefundinfo).\",\n \"5-0\": \"`transactionMetaData`\",\n \"5-1\": \"*object*\",\n \"5-2\": \"Optional\",\n \"5-3\": \"See [transactionMetaData](doc:transaction-meta-data).\",\n \"1-0\": \"`taxAmount`\",\n \"1-1\": \"*decimal*\",\n \"1-2\": \"Optional\",\n \"1-3\": \"Tax amount to be refunded, if this is a partial refund. Remember to also specify the total refund amount (including tax) in the `amount` parameter. See the [Taxes guide](https://developers.bluesnap.com/v8976-Basics/docs/taxes) for more details.\"\n },\n \"cols\": 4,\n \"rows\": 6\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\": \"`amount`\",\n \"0-1\": \"*decimal*\",\n \"0-2\": \"Refund amount, positive value.\",\n \"2-0\": \"`currency`\",\n \"3-0\": \"`date`\",\n \"2-1\": \"*string*\",\n \"3-1\": \"*string*\",\n \"3-2\": \"Refund date.\",\n \"2-2\": \"Currency of refund amount.\",\n \"5-0\": \"`vendorAmount`\",\n \"5-1\": \"*decimal*\",\n \"5-2\": \"The total vendor portion of the refund amount. Only available if one or more vendor IDs were included in original transaction.\",\n \"6-0\": \"`vendorsRefundInfo`\",\n \"6-1\": \"*object*\",\n \"6-2\": \"See [vendorsRefundInfo](doc:vendorsrefundinfo).\",\n \"4-0\": \"`refundTransactionId`\",\n \"4-1\": \"*integer*\",\n \"4-2\": \"BlueSnap identifier for the refund.\",\n \"7-0\": \"`transactionMetaData`\",\n \"7-1\": \"*object*\",\n \"7-2\": \"See [transactionMetaData](doc:transaction-meta-data).\",\n \"8-0\": \"`reason`\",\n \"8-1\": \"*string*\",\n \"8-2\": \"Reason the shopper cancelled or requested a refund for the order.\",\n \"9-0\": \"`cancelSubscriptions`\",\n \"9-1\": \"*boolean*\",\n \"9-2\": \"Whether to cancel the subscription associated with the transaction ID.\",\n \"1-0\": \"`taxAmount`\",\n \"1-1\": \"*decimal*\",\n \"1-2\": \"The tax amount that was refunded.\"\n },\n \"cols\": 3,\n \"rows\": 10\n}\n[/block]","updates":[],"order":39,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"628531cd1258c8003f6dd20d","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"JSON Objects","slug":"resources","order":16,"from_sync":false,"reference":false,"_id":"628531cd1258c8003f6dd1ca","version":"628531cd1258c8003f6dd27d","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2015-10-15T16:20:51.519Z","__v":0},"project":"57336fd5a6a9c40e00e13a0b","user":"560d5913af97231900938124","parentDoc":null,"version":{"version":"8976-JSON","version_clean":"8976.0.0-JSON","codename":"3.42 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["628531cd1258c8003f6dd1bf","628531cd1258c8003f6dd1c0","628531cd1258c8003f6dd1c1","628531cd1258c8003f6dd1c2","628531cd1258c8003f6dd1c3","628531cd1258c8003f6dd1c4","628531cd1258c8003f6dd1c5","628531cd1258c8003f6dd1c6","628531cd1258c8003f6dd1c7","628531cd1258c8003f6dd1c8","628531cd1258c8003f6dd1c9","628531cd1258c8003f6dd1ca","628531cd1258c8003f6dd1cb","628531cd1258c8003f6dd1cc","628531cd1258c8003f6dd1cd","628531cd1258c8003f6dd1ce","628531cd1258c8003f6dd1cf","628531cd1258c8003f6dd1d0","628531cd1258c8003f6dd1d1","628531cd1258c8003f6dd1d2"],"_id":"628531cd1258c8003f6dd27d","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"622783372cd60c003782d77e","createdAt":"2018-04-24T15:22:41.561Z","releaseDate":"2018-04-24T15:22:41.561Z"},"createdAt":"2016-09-23T16:54:49.971Z","githubsync":"","__v":0}
refund
amount
decimal
Optional
Amount to be refunded, if this is a partial refund.
Value must be greater than 0 and must not exceed the total transaction amount.
taxAmount
decimal
Optional
Tax amount to be refunded, if this is a partial refund. Remember to also specify the total refund amount (including tax) in the amount
parameter. See the Taxes guide for more details.
reason
string
Optional
Reason the shopper cancelled or requested a refund for the order.
Default value is "Per your instructions".
Maximum 4000 characters.
cancelSubscriptions
boolean
Optional
Whether to cancel the subscription associated with the transaction ID.
Values:
true (default) - Cancel the subscription and refund the charge
false - Do not cancel the subscription. Just refund the charge.
vendorsRefundInfo
object
Optional
Only applicable to partial refunds (if amount
was passed). Contains the details about the Marketplace vendors' portion of the refund.
See vendorsRefundInfo.
amount
decimal
Refund amount, positive value.
taxAmount
decimal
The tax amount that was refunded.
currency
string
Currency of refund amount.
date
string
Refund date.
refundTransactionId
integer
BlueSnap identifier for the refund.
vendorAmount
decimal
The total vendor portion of the refund amount. Only available if one or more vendor IDs were included in original transaction.
reason
string
Reason the shopper cancelled or requested a refund for the order.
cancelSubscriptions
boolean
Whether to cancel the subscription associated with the transaction ID.