Platební metody
Tyto metody slouží k zjištění, které instrumenty GoPay nabízí pro váš obchod (goid) a měnu — před sestavením checkout UI nebo serverového směrování.
getPaymentInstruments(goid, currency) — pro konkrétní měnugetPaymentInstrumentsAll(goid) — napříč měnami
Podle měny
import { Currency, createGoPayClient } from 'gopay-sdk';
const client = createGoPayClient({
goid: 8123456789,
clientId: process.env.GOPAY_CLIENT_ID!,
clientSecret: process.env.GOPAY_CLIENT_SECRET!,
gatewayUrl: 'https://gw.sandbox.gopay.com/api',
});
const methods = await client.getPaymentInstruments(8123456789, Currency.CZK);
for (const instrument of methods.enabledPaymentInstruments) {
console.log(instrument.paymentInstrument, instrument.group);
}
Všechny měny
const methodsAll = await client.getPaymentInstrumentsAll(8123456789);
const list = Array.isArray(methodsAll.enabledPaymentInstruments)
? methodsAll.enabledPaymentInstruments
: Object.values(methodsAll.enabledPaymentInstruments);
for (const item of list) {
console.log(item.group, item.currencies);
}
Praktické použití
- Výběr platebních metod v UI podle země/měny.
- Skrytí nepodporovaných instrumentů před vytvořením platby.
- Konzistentní UX s aktuálními možnostmi obchodníka.