GET /merchants/{id}/banks lists the banks a payment transaction to the merchant could be paid from, for a customer in country paying in currency. They’re the banks Quidkey’s checkout offers that customer, so you can show them on your own page, such as bank buttons. Send the one the customer chooses as authorization.bank when you create the payment transaction, and the checkout opens with it chosen.
Response
The list pages as every list does, with
limit and cursor. See Lists, pagination and filters.
Order
The country’s popular banks come first, in the order Quidkey curates for it, then every other bank by name. The order is the same for every customer and every request, so a cursor carries on where the last page ended. The banks follow the merchant’s route for that country and currency, so two merchants can see different lists for the same customer. A test payment transaction’s route can offer banks a live one doesn’t.Refusals
A route a payment transaction can’t take is refused with the code that creating a payment transaction gives. Listing a live route’s banks doesn’t need the merchant to take live payment transactions.Reading One Bank
GET /banks/{id} reads one bank, which is what each entry’s _uri names. It’s reference data, read with banks:get. A bank Quidkey doesn’t offer answers 404.