{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","results":{"codes":[]},"settings":"","params":[]},"next":{"description":"","pages":[]},"title":"Marketplace Errors","type":"basic","slug":"marketplace-errors","excerpt":"","body":"The following errors can be returned in response to a transaction request involving a marketplace vendor or in a create or update vendor request. \n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"14030\",\n    \"1-0\": \"14031\",\n    \"2-0\": \"14032\",\n    \"3-0\": \"14033\",\n    \"0-1\": \"REFUND_VENDOR_AMOUNT_NOT_SUPPORTED\",\n    \"1-1\": \"REFUND_NEGATIVE_VENDOR_AMOUNT\",\n    \"2-1\": \"REFUND_MAX_VENDOR_AMOUNT_FAILURE\",\n    \"3-1\": \"REFUND_MAX_MERCHANT_AMOUNT_FAILURE\",\n    \"0-2\": \"Vendor refund amount is not supported for transactions without a vendor involved.\",\n    \"1-2\": \"Vendor refund failed because the amount must be greater than zero.\",\n    \"2-2\": \"Vendor refund amount cannot be more than the refundable amount.\",\n    \"3-2\": \"Merchant refund amount cannot be more than the refundable amount.\",\n    \"h-0\": \"Code\",\n    \"h-1\": \"Name\",\n    \"h-2\": \"Description\",\n    \"14-0\": \"20050\",\n    \"15-0\": \"20051\",\n    \"16-0\": \"20052\",\n    \"14-1\": \"UNAUTHORIZED_USE_OF_VENDOR\",\n    \"15-1\": \"VALIDATION_GENERAL_FAILURE\",\n    \"16-1\": \"INACTIVE_VENDOR\",\n    \"16-2\": \"Vendor {vendor ID} is inactive.\",\n    \"14-2\": \"User: {Merchant's API Username} is not authorized to act on vendor: {vendor ID}.\",\n    \"4-0\": \"14034\",\n    \"4-1\": \"VENDOR_PAYOUT_VALUES_EXCEEDS_MERCHANT\",\n    \"4-2\": \"Vendor payout values for frequency and delay cannot result in a quicker payout than approved for master merchant.\",\n    \"17-0\": \"20053\",\n    \"17-1\": \"DECLINED_VENDOR\",\n    \"17-2\": \"Vendor not approved for transaction processing.\",\n    \"5-0\": \"14035\",\n    \"5-1\": \"DUPLICATE_VENDOR\",\n    \"5-2\": \"The same vendor was included multiple times on a single transaction.\",\n    \"7-0\": \"14037\",\n    \"7-1\": \"VENDOR_COMMISSION_EXCEEDED\",\n    \"7-2\": \"The total amount of commission for all merchants and vendors on a single transaction can’t exceed 100% if using % commission or the total amount of the sale if using a flat amount\",\n    \"6-0\": \"14036\",\n    \"6-1\": \"VENDOR_LIMIT_MAX\",\n    \"6-2\": \"The maximum number of vendors allowed per transaction is 10\",\n    \"15-2\": \"Vendor {vendor ID} has both commission percent and commission amount values specified in the vendor agreement. The vendor agreement must include a percent commission or an amount commission, but not both.\",\n    \"9-0\": \"14043\",\n    \"9-1\": \"REFUND_INVALID_VENDOR_REFUND_AMOUNT\",\n    \"9-2\": \"Vendor amount is invalid.\",\n    \"10-0\": \"14044\",\n    \"10-1\": \"REFUND_VENDOR_ERROR\",\n    \"10-2\": \"Vendor refund amount params should be used when transaction contains more than one vendor.\",\n    \"11-0\": \"14045\",\n    \"11-1\": \"REFUND_INVALID_VENDOR\",\n    \"11-2\": \"The vendor does not relate to specified transaction.\",\n    \"12-0\": \"14046\",\n    \"12-1\": \"VENDOR_ALREADY_FULLY_REFUNDED\",\n    \"12-2\": \"The vendor has already been fully refunded.\",\n    \"13-0\": \"14047\",\n    \"13-1\": \"REFUND_NEGATIVE_MERCHANT_AMOUNT\",\n    \"13-2\": \"Merchant refund amount cannot be negative.\",\n    \"8-0\": \"14038\",\n    \"8-1\": \"VENDOR_RESERVE_NONE_DEFAULT_METHOD\",\n    \"8-2\": \"Reserve can be set only for the default payout method\"\n  },\n  \"cols\": 3,\n  \"rows\": 18\n}\n[/block]","updates":[],"order":5,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5ed5174637c3c607440c09ec","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Errors","slug":"errors","order":13,"from_sync":false,"reference":false,"_id":"5ed5174637c3c607440c0996","version":"5ed5174637c3c607440c0a3c","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2015-10-15T16:21:09.840Z","__v":0},"project":"57336fd5a6a9c40e00e13a0b","parentDoc":null,"user":"560d5913af97231900938124","version":{"version":"8976-XML","version_clean":"8976.0.0-XML","codename":"3.34.0 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5ed5174637c3c607440c098b","5ed5174637c3c607440c098c","5ed5174637c3c607440c098d","5ed5174637c3c607440c098e","5ed5174637c3c607440c098f","5ed5174637c3c607440c0990","5ed5174637c3c607440c0991","5ed5174637c3c607440c0992","5ed5174637c3c607440c0993","5ed5174637c3c607440c0994","5ed5174637c3c607440c0995","5ed5174637c3c607440c0996","5ed5174637c3c607440c0997","5ed5174637c3c607440c0998","5ed5174637c3c607440c0999","5ed5174637c3c607440c099a","5ed5174637c3c607440c099b","5ed5174637c3c607440c099c"],"_id":"5ed5174637c3c607440c0a3c","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"5e5d3a02fb6fb40050cb3c15","createdAt":"2018-04-24T15:24:22.608Z","releaseDate":"2018-04-24T15:24:22.608Z"},"createdAt":"2016-12-05T13:12:00.303Z","githubsync":"","__v":0}

Payment API (XML)

Card/Wallet Transactions

PayPal Transactions

ACH/ECP Transactions

SEPA Direct Debit Transactions

Local Bank Transfer transactions

Batch Transactions

Refunds

Vaulted Shoppers

Subscriptions

Fraud Review

Marketplace

Wallets

Errors

Resources

Test Data & Codes

Guides & Tools

Mobile SDK

Marketplace Errors

The following errors can be returned in response to a transaction request involving a marketplace vendor or in a create or update vendor request.

Code
Name
Description

14030

REFUND_VENDOR_AMOUNT_NOT_SUPPORTED

Vendor refund amount is not supported for transactions without a vendor involved.

14031

REFUND_NEGATIVE_VENDOR_AMOUNT

Vendor refund failed because the amount must be greater than zero.

14032

REFUND_MAX_VENDOR_AMOUNT_FAILURE

Vendor refund amount cannot be more than the refundable amount.

14033

REFUND_MAX_MERCHANT_AMOUNT_FAILURE

Merchant refund amount cannot be more than the refundable amount.

14034

VENDOR_PAYOUT_VALUES_EXCEEDS_MERCHANT

Vendor payout values for frequency and delay cannot result in a quicker payout than approved for master merchant.

14035

DUPLICATE_VENDOR

The same vendor was included multiple times on a single transaction.

14036

VENDOR_LIMIT_MAX

The maximum number of vendors allowed per transaction is 10

14037

VENDOR_COMMISSION_EXCEEDED

The total amount of commission for all merchants and vendors on a single transaction can’t exceed 100% if using % commission or the total amount of the sale if using a flat amount

14038

VENDOR_RESERVE_NONE_DEFAULT_METHOD

Reserve can be set only for the default payout method

14043

REFUND_INVALID_VENDOR_REFUND_AMOUNT

Vendor amount is invalid.

14044

REFUND_VENDOR_ERROR

Vendor refund amount params should be used when transaction contains more than one vendor.

14045

REFUND_INVALID_VENDOR

The vendor does not relate to specified transaction.

14046

VENDOR_ALREADY_FULLY_REFUNDED

The vendor has already been fully refunded.

14047

REFUND_NEGATIVE_MERCHANT_AMOUNT

Merchant refund amount cannot be negative.

20050

UNAUTHORIZED_USE_OF_VENDOR

User: {Merchant's API Username} is not authorized to act on vendor: {vendor ID}.

20051

VALIDATION_GENERAL_FAILURE

Vendor {vendor ID} has both commission percent and commission amount values specified in the vendor agreement. The vendor agreement must include a percent commission or an amount commission, but not both.

20052

INACTIVE_VENDOR

Vendor {vendor ID} is inactive.

20053

DECLINED_VENDOR

Vendor not approved for transaction processing.