Merchant Approve Transaction

{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/transactions/approval","auth":"optional","settings":"","results":{"codes":[{"code":"","language":"text"}]},"method":"put","examples":{"codes":[]},"params":[{"name":"transactionid","type":"string","default":"","desc":"either `transactionid` or `merchanttransactionid` is <b>required</b><br />ID of the transaction to be approved/declined","required":false,"in":"path","ref":"","_id":"57b6ec9e49a12a0e007b469d"},{"name":"merchanttransactionid","type":"string","default":"","desc":"either `transactionid` or `merchanttransactionid` is <b>required</b><br />merchant's transaction ID number for the transaction to be approved/declined","required":false,"in":"path","ref":"","_id":"5e5d698e2d9cf700347de893"},{"name":"approvetransaction","type":"boolean","default":"true","desc":"Set to `true` to approve the transaction or to `false` to decline the transaction. Default value is `true`.","required":false,"in":"path","ref":"","_id":"5ed568a3ba7e3a06e5b736cd"}]},"next":{"description":"","pages":[]},"title":"Merchant Approve Transaction","type":"endpoint","slug":"merchant-approval","excerpt":"","body":"[block:html]\n{\n \"html\": \"<script>\\n // hide body textbox of API Explorer\\n $(document).ready(function() {\\n $(\\\"textarea[placeholder='Body Content']\\\").hide(); \\n }); \\n</script> \"\n}\n[/block]\nThe Merchant Approve Transaction request lets you approve or decline transactions with invoice status of PENDING_MERCHANT_REVIEW.\n\n<a class=\"btn btn-success\" href=\"#section-api-explorer\" role=\"button\">Try it in the API Explorer</a>\n\n###Request Content\nThe request must include either the `transactionid` or `merchanttransactionid`. \n\nFor example: \n\n>`services/2/transactions/approval?transactionid=38612140&approvetransaction=true`\n\nOR\n\n>`services/2/transactions/approval?merchanttransactionid=MyUniqueMTI&approvetransaction=true`\n\n**Note:** If `approvetransaction` is not included, `true` is assumed.\n\n###Response Details\nIf successful, the response HTTP status code is `200 OK` and will include the following parameters:\n\n**Possible Responses**\n[block:parameters]\n{\n \"data\": {\n \"h-0\": \"Case\",\n \"0-0\": \"**Approve**\",\n \"1-0\": \"* Auth Only (with amount > 0)\",\n \"1-1\": \"with `transaction-id`\\n```xml\\n<merchant-approval xmlns=\\\"http://ws.plimus.com\\\">\\n <transaction-id>38611602</transaction-id>\\n <transaction-status>Waiting</transaction-status>\\n</merchant-approval>\\n```\\n\\nwith `merchant-transaction-id`\\n```xml\\n<merchant-approval xmlns=\\\"http://ws.plimus.com\\\">\\n <transaction-id>38611602</transaction-id>\\n <transaction-status>Waiting</transaction-status>\\n <merchant-transaction-id>MerchantTransactionID122222</merchant-transaction-id>\\n</merchant-approval>\\n```\",\n \"h-1\": \"Examples\",\n \"2-0\": \"* Auth Only (with amount = 0)\\n* Auth Capture \\n* Create PayPal Transaction\\n* Create Local Bank Transfer Transaction\",\n \"3-0\": \"* Create Subscription\\n* Create Merchant-Managed Subscription\",\n \"4-0\": \"**Decline**\",\n \"5-0\": \"* Create Local Bank Transfer Transaction\",\n \"6-0\": \"* all others\",\n \"2-1\": \"with `transaction-id`\\n```xml\\n<merchant-approval xmlns=\\\"http://ws.plimus.com\\\">\\n <transaction-id>38611602</transaction-id>\\n <transaction-status>Approved</transaction-status>\\n</merchant-approval>\\n```\\n\\nwith `merchant-transaction-id`\\n```xml\\n<merchant-approval xmlns=\\\"http://ws.plimus.com\\\">\\n <transaction-id>38611602</transaction-id>\\n <transaction-status>Approved</transaction-status>\\n <merchant-transaction-id>MerchantTransactionID122222</merchant-transaction-id>\\n</merchant-approval>\\n```\",\n \"3-1\": \"with `transaction-id`\\n```xml\\n<merchant-approval xmlns=\\\"http://ws.plimus.com\\\">\\n <subscription-id>39606170</subscription-id>\\n <transaction-id>38611602</transaction-id>\\n <transaction-status>Approved</transaction-status>\\n</merchant-approval>\\n```\\n\\nwith `merchant-transaction-id`\\n```xml\\n<merchant-approval xmlns=\\\"http://ws.plimus.com\\\">\\n <subscription-id>39606170</subscription-id>\\n <transaction-id>38611602</transaction-id>\\n <transaction-status>Approved</transaction-status>\\n <merchant-transaction-id>MerchantTransactionID122222</merchant-transaction-id>\\n</merchant-approval>\\n```\",\n \"5-1\": \"with `transaction-id`\\n```xml\\n<merchant-approval xmlns=\\\"http://ws.plimus.com\\\">\\n <transaction-id>38611602</transaction-id>\\n <transaction-status>Short OrderContext Declined By Vendor (Refund Needed)</transaction-status>\\n</merchant-approval>\\n```\\n\\nwith `merchant-transaction-id`\\n```xml\\n<merchant-approval xmlns=\\\"http://ws.plimus.com\\\">\\n <transaction-id>38611602</transaction-id>\\n <transaction-status>Short OrderContext Declined By Vendor (Refund Needed)</transaction-status>\\n <merchant-transaction-id>MerchantTransactionID122222</merchant-transaction-id>\\n</merchant-approval>\\n```\",\n \"6-1\": \"with `transaction-id`\\n```xml\\n<merchant-approval xmlns=\\\"http://ws.plimus.com\\\">\\n <transaction-id>38611602</transaction-id>\\n <transaction-status>Canceled</transaction-status>\\n</merchant-approval>\\n```\\n\\nwith `merchant-transaction-id`\\n```xml\\n<merchant-approval xmlns=\\\"http://ws.plimus.com\\\">\\n <transaction-id>38611602</transaction-id>\\n <transaction-status>Canceled</transaction-status>\\n <merchant-transaction-id>MerchantTransactionID122222</merchant-transaction-id>\\n</merchant-approval>\\n```\"\n },\n \"cols\": 2,\n \"rows\": 7\n}\n[/block]\n<hr>\n\n##Example\n\n###Request Example\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"curl -v -X PUT https://sandbox.bluesnap.com/services/2/transactions/approval?transactionid=38612140&approvetransaction=true \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\",\n \"language\": \"curl\",\n \"name\": \"Request: Approve transaction\"\n },\n {\n \"code\": \"curl -v -X PUT https://sandbox.bluesnap.com/services/2/transactions/approval?transactionid=38612140&approvetransaction=false \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\",\n \"language\": \"curl\",\n \"name\": \"Request: Decline transaction\"\n }\n ]\n}\n[/block]\n###Response Examples\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"<merchant-approval xmlns=\\\"http://ws.plimus.com\\\">\\n <transaction-id>38611602</transaction-id>\\n <transaction-status>Approved</transaction-status>\\n</merchant-approval>\",\n \"language\": \"xml\",\n \"name\": \"Response: 200 OK with Transaction ID\"\n },\n {\n \"code\": \"<merchant-approval xmlns=\\\"http://ws.plimus.com\\\">\\n <transaction-id>38611602</transaction-id>\\n <transaction-status>Approved</transaction-status>\\n <merchant-transaction-id>MerchantTransactionID122222</merchant-transaction-id>\\n</merchant-approval>\",\n \"language\": \"xml\",\n \"name\": \"with Merchant Transaction ID\"\n }\n ]\n}\n[/block]\n<hr>\n\n##API Explorer\nTo test a call, enter an existing transaction ID in the `transaction-id` field. This automatically inserts the ID into the request URL.","updates":[],"order":1,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"603d5be8af8f1a00611381a7","project":"57336fd5a6a9c40e00e13a0b","version":{"version":"8976-XML","version_clean":"8976.0.0-XML","codename":"3.37 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["603d5be8af8f1a00611380fb","603d5be8af8f1a00611380fc","603d5be8af8f1a00611380fd","603d5be8af8f1a00611380fe","603d5be8af8f1a00611380ff","603d5be8af8f1a0061138100","603d5be8af8f1a0061138101","603d5be8af8f1a0061138102","603d5be8af8f1a0061138103","603d5be8af8f1a0061138104","603d5be8af8f1a0061138105","603d5be8af8f1a0061138106","603d5be8af8f1a0061138107","603d5be8af8f1a0061138108","603d5be8af8f1a0061138109","603d5be8af8f1a006113810a","603d5be8af8f1a006113810b","603d5be8af8f1a006113810c","603d5be8af8f1a006113810d","603d5be8af8f1a006113810e"],"_id":"603d5be8af8f1a00611381ba","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"5ff4b747849e1b03c50684c7","createdAt":"2018-04-24T15:24:22.608Z","releaseDate":"2018-04-24T15:24:22.608Z"},"category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Fraud Review","slug":"fraud","order":12,"from_sync":false,"reference":false,"_id":"603d5be8af8f1a006113810b","project":"57336fd5a6a9c40e00e13a0b","version":"603d5be8af8f1a00611381ba","createdAt":"2020-03-02T20:01:10.436Z","__v":0},"user":"5beb1b96bc2003003ecd645e","createdAt":"2020-03-02T20:10:58.520Z","__v":28,"parentDoc":null}

The Merchant Approve Transaction request lets you approve or decline transactions with invoice status of PENDING_MERCHANT_REVIEW.

Try it in the API Explorer

Request Content

The request must include either the transactionid or merchanttransactionid.

For example:

services/2/transactions/approval?transactionid=38612140&approvetransaction=true

services/2/transactions/approval?merchanttransactionid=MyUniqueMTI&approvetransaction=true

Note: If approvetransaction is not included, true is assumed.

Response Details

If successful, the response HTTP status code is 200 OK and will include the following parameters:

Possible Responses

Case

Examples

Approve

Auth Only (with amount > 0)

with transaction-id

<merchant-approval xmlns="http://ws.plimus.com">
    <transaction-id>38611602</transaction-id>
    <transaction-status>Waiting</transaction-status>
</merchant-approval>