Merchant Approve Transaction

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


📘

Tip

You can test out a request that hits our sandbox in real-time. Follow the instructions here to use the "Try It!" feature on the right side.

Request Content

The request must include either the transactionid or merchanttransactionid.

For example:

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

OR

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>

with merchant-transaction-id

<merchant-approval xmlns="http://ws.plimus.com">
    <transaction-id>38611602</transaction-id>
    <transaction-status>Waiting</transaction-status>
    <merchant-transaction-id>MerchantTransactionID122222</merchant-transaction-id>
</merchant-approval>
  • Auth Only (with amount = 0)
  • Auth Capture
  • Create PayPal Transaction
  • Create Local Bank Transfer Transaction

with transaction-id

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

with merchant-transaction-id

<merchant-approval xmlns="http://ws.plimus.com">
    <transaction-id>38611602</transaction-id>
    <transaction-status>Approved</transaction-status>
    <merchant-transaction-id>MerchantTransactionID122222</merchant-transaction-id>
</merchant-approval>
  • Create Subscription
  • Create Merchant-Managed Subscription

with transaction-id

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

with merchant-transaction-id

<merchant-approval xmlns="http://ws.plimus.com">
    <subscription-id>39606170</subscription-id>
    <transaction-id>38611602</transaction-id>
    <transaction-status>Approved</transaction-status>
    <merchant-transaction-id>MerchantTransactionID122222</merchant-transaction-id>
</merchant-approval>

Decline

  • Create Local Bank Transfer Transaction

with transaction-id

<merchant-approval xmlns="http://ws.plimus.com">
    <transaction-id>38611602</transaction-id>
    <transaction-status>Short OrderContext Declined By Vendor &#x28;Refund Needed&#x29;</transaction-status>
</merchant-approval>

with merchant-transaction-id

<merchant-approval xmlns="http://ws.plimus.com">
    <transaction-id>38611602</transaction-id>
    <transaction-status>Short OrderContext Declined By Vendor &#x28;Refund Needed&#x29;</transaction-status>
    <merchant-transaction-id>MerchantTransactionID122222</merchant-transaction-id>
</merchant-approval>
  • all others

with transaction-id

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

with merchant-transaction-id

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

Example

Request Example

curl -v -X PUT https://sandbox.bluesnap.com/services/2/transactions/approval?transactionid=38612140&approvetransaction=true \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \ 
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
curl -v -X PUT https://sandbox.bluesnap.com/services/2/transactions/approval?transactionid=38612140&approvetransaction=false \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \ 
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '

Response Examples

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

API Explorer

To test a call, enter an existing transaction ID in the transaction-id field. This automatically inserts the ID into the request URL.

Language
Authentication
Header
Click Try It! to start a request and see the response here!