Restricting Payments

Restriction limits may need implementing to stop transactions; for instance preventing transactions on particular cards for fraud reasons. This can be achieved by placing a ban for the card or IP address on the payment profile.

View all banned entries

All banned entries can be retrieved by making a GET request to the https://api.vendreo.com/v1/card/bans (Full example: docs) endpoint.

Banning a card or IP address

A ban can be created to target a card PAN hash or IP address by making a POST request to the https://api.vendreo.com/v1/card/bans/add (Full example: docs) endpoint.

Remove a banned card or IP address

A ban can be removed from a card or IP address by making a DELETE request to the https://api.vendreo.com/v1/card/bans/{ban}/remove (Full example: docs) endpoint.

What happens when a user uses a banned card or IP address

When a user tries to use a banned card or IP address, the payment request will be marked as inactive, and you will receive a card_payment_request_forbidden webhook event alongside a onFailed event on the JS SDK.

Information will be limited on the JS Callback, so you should use the webhook event to get more information about the ban details.