{"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    \"0-1\": \"REFUND_VENDOR_AMOUNT_NOT_SUPPORTED\",\n    \"1-1\": \"REFUND_NEGATIVE_VENDOR_AMOUNT\",\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    \"h-0\": \"Code\",\n    \"h-1\": \"Name\",\n    \"h-2\": \"Description\",\n    \"11-0\": \"20050\",\n    \"12-0\": \"20051\",\n    \"13-0\": \"20052\",\n    \"11-1\": \"UNAUTHORIZED_USE_OF_VENDOR\",\n    \"12-1\": \"VALIDATION_GENERAL_FAILURE\",\n    \"13-1\": \"INACTIVE_VENDOR\",\n    \"13-2\": \"Vendor {vendor ID} is inactive.\",\n    \"11-2\": \"User: {Merchant's API Username} is not authorized to act on vendor: {vendor ID}.\",\n    \"2-0\": \"14034\",\n    \"2-1\": \"VENDOR_PAYOUT_VALUES_EXCEEDS_MERCHANT\",\n    \"2-2\": \"Vendor payout values for frequency and delay cannot result in a quicker payout than approved for master merchant.\",\n    \"14-0\": \"20053\",\n    \"14-1\": \"DECLINED_VENDOR\",\n    \"14-2\": \"Vendor not approved for transaction processing.\",\n    \"3-0\": \"14035\",\n    \"3-1\": \"DUPLICATE_VENDOR\",\n    \"3-2\": \"The same vendor was included multiple times on a single transaction.\",\n    \"5-0\": \"14037\",\n    \"5-1\": \"VENDOR_COMMISSION_EXCEEDED\",\n    \"5-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    \"4-0\": \"14036\",\n    \"4-1\": \"VENDOR_LIMIT_MAX\",\n    \"4-2\": \"The maximum number of vendors allowed per transaction is 10\",\n    \"12-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    \"7-0\": \"14043\",\n    \"7-1\": \"REFUND_INVALID_VENDOR_REFUND_AMOUNT\",\n    \"7-2\": \"Vendor amount is invalid.\",\n    \"8-0\": \"14044\",\n    \"8-1\": \"REFUND_VENDOR_ERROR\",\n    \"8-2\": \"Vendor refund amount params should be used when transaction contains more than one vendor.\",\n    \"9-0\": \"14045\",\n    \"9-1\": \"REFUND_INVALID_VENDOR\",\n    \"9-2\": \"The vendor does not relate to specified transaction.\",\n    \"10-0\": \"14047\",\n    \"10-1\": \"REFUND_NEGATIVE_MERCHANT_AMOUNT\",\n    \"10-2\": \"Merchant refund amount cannot be negative.\",\n    \"6-0\": \"14038\",\n    \"6-1\": \"VENDOR_RESERVE_NONE_DEFAULT_METHOD\",\n    \"6-2\": \"Reserve can be set only for the default payout method\"\n  },\n  \"cols\": 3,\n  \"rows\": 15\n}\n[/block]","updates":[],"order":5,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5fd26704abd1b6004f12d6d5","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Errors","slug":"errors","order":15,"from_sync":false,"reference":false,"_id":"5fd26704abd1b6004f12d67e","version":"5fd26704abd1b6004f12d72c","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.36 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5fd26704abd1b6004f12d673","5fd26704abd1b6004f12d674","5fd26704abd1b6004f12d675","5fd26704abd1b6004f12d676","5fd26704abd1b6004f12d677","5fd26704abd1b6004f12d678","5fd26704abd1b6004f12d679","5fd26704abd1b6004f12d67a","5fd26704abd1b6004f12d67b","5fd26704abd1b6004f12d67c","5fd26704abd1b6004f12d67d","5fd26704abd1b6004f12d67e","5fd26704abd1b6004f12d67f","5fd26704abd1b6004f12d680","5fd26704abd1b6004f12d681","5fd26704abd1b6004f12d682","5fd26704abd1b6004f12d683","5fd26704abd1b6004f12d684","5fd26704abd1b6004f12d685","5fd97a5a79ae260012a454d2"],"_id":"5fd26704abd1b6004f12d72c","project":"57336fd5a6a9c40e00e13a0b","__v":1,"forked_from":"5f43d7f192d43e01ff6f11c2","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

iDEAL Transactions

Local Bank Transfer transactions

SEPA Direct Debit Transactions

Sofort 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.

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.

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.