put https://sandbox.bluesnap.com/services/2/transactions/approval
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-idxml <merchant-approval xmlns="http://ws.plimus.com"> <transaction-id>38611602</transaction-id> <transaction-status>Waiting</transaction-status> </merchant-approval> with merchant-transaction-idxml <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-idxml <merchant-approval xmlns="http://ws.plimus.com"> <transaction-id>38611602</transaction-id> <transaction-status>Approved</transaction-status> </merchant-approval> with merchant-transaction-idxml <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-idxml <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-idxml <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-idxml <merchant-approval xmlns="http://ws.plimus.com"> <transaction-id>38611602</transaction-id> <transaction-status>Short OrderContext Declined By Vendor (Refund Needed)</transaction-status> </merchant-approval> with merchant-transaction-idxml <merchant-approval xmlns="http://ws.plimus.com"> <transaction-id>38611602</transaction-id> <transaction-status>Short OrderContext Declined By Vendor (Refund Needed)</transaction-status> <merchant-transaction-id>MerchantTransactionID122222</merchant-transaction-id> </merchant-approval> |
| * all others | with transaction-idxml <merchant-approval xmlns="http://ws.plimus.com"> <transaction-id>38611602</transaction-id> <transaction-status>Canceled</transaction-status> </merchant-approval> with merchant-transaction-idxml <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.