curl https://bukio-backend-production.up.railway.app/v1/payments/methods \
-H "Authorization: Bearer bk_live_..."
const res = await fetch("https://bukio-backend-production.up.railway.app/v1/payments/methods", {
headers: { Authorization: `Bearer ${process.env.BUKIO_API_KEY}` },
});
const { items } = await res.json();
const available = items.filter((m) => m.available);
import os, requests
res = requests.get(
"https://bukio-backend-production.up.railway.app/v1/payments/methods",
headers={"Authorization": f"Bearer {os.environ['BUKIO_API_KEY']}"},
)
available = [m for m in res.json()["items"] if m["available"]]
{
"items": [
{ "method": "pix", "title": "Pix", "available": true, "minAmount": 100, "maxAmount": null },
{ "method": "card", "title": "Cartão de crédito", "available": true, "minAmount": 500, "maxAmount": 200000, "installments": 1, "holdDays": 15 },
{
"method": "crypto",
"title": "Cripto",
"available": true,
"minAmount": 200,
"maxAmount": 200000,
"currencies": [
{ "id": "ltc", "title": "Litecoin (LTC)" },
{ "id": "btc", "title": "Bitcoin (BTC)" },
{ "id": "eth", "title": "Ethereum (ETH)" }
]
}
]
}
Cobranças
Formas de pagamento
As formas que a conta pode usar agora (Pix, cartão de crédito e cripto), com a faixa de valor e as moedas aceitas.
GET
/
v1
/
payments
/
methods
curl https://bukio-backend-production.up.railway.app/v1/payments/methods \
-H "Authorization: Bearer bk_live_..."
const res = await fetch("https://bukio-backend-production.up.railway.app/v1/payments/methods", {
headers: { Authorization: `Bearer ${process.env.BUKIO_API_KEY}` },
});
const { items } = await res.json();
const available = items.filter((m) => m.available);
import os, requests
res = requests.get(
"https://bukio-backend-production.up.railway.app/v1/payments/methods",
headers={"Authorization": f"Bearer {os.environ['BUKIO_API_KEY']}"},
)
available = [m for m in res.json()["items"] if m["available"]]
{
"items": [
{ "method": "pix", "title": "Pix", "available": true, "minAmount": 100, "maxAmount": null },
{ "method": "card", "title": "Cartão de crédito", "available": true, "minAmount": 500, "maxAmount": 200000, "installments": 1, "holdDays": 15 },
{
"method": "crypto",
"title": "Cripto",
"available": true,
"minAmount": 200,
"maxAmount": 200000,
"currencies": [
{ "id": "ltc", "title": "Litecoin (LTC)" },
{ "id": "btc", "title": "Bitcoin (BTC)" },
{ "id": "eth", "title": "Ethereum (ETH)" }
]
}
]
}
Escopo
payments:write, card:write ou crypto:write: a lista traz só as formas que a chave pode cobrar. Use antes de mostrar as opções para o seu cliente: mostre só as que vêm com available: true e respeite a faixa de valor de cada uma. Uma forma pode ficar indisponível por um tempo; criar uma cobrança nela responde 422 METHOD_UNAVAILABLE.
Resposta
array
Uma linha por forma, sempre nesta ordem: Pix, cartão, cripto.
Show propriedades
Show propriedades
string
pix, card ou crypto: o valor do campo method em Criar cobrança.string
Pix, Cartão de crédito ou Cripto.
boolean
Se dá para cobrar por ela agora.
integer
Valor mínimo em centavos (cartão: 500; cripto: 200).
integer | null
Valor máximo em centavos, ou
null sem teto próprio.integer
Só no cartão: número de parcelas (
1, à vista).integer
Só no cartão: em quantos dias a venda aprovada entra no saldo disponível (padrão
15, D+15).array
Só na cripto: as moedas aceitas, cada uma com
id (o valor de cryptoCurrency) e title.curl https://bukio-backend-production.up.railway.app/v1/payments/methods \
-H "Authorization: Bearer bk_live_..."
const res = await fetch("https://bukio-backend-production.up.railway.app/v1/payments/methods", {
headers: { Authorization: `Bearer ${process.env.BUKIO_API_KEY}` },
});
const { items } = await res.json();
const available = items.filter((m) => m.available);
import os, requests
res = requests.get(
"https://bukio-backend-production.up.railway.app/v1/payments/methods",
headers={"Authorization": f"Bearer {os.environ['BUKIO_API_KEY']}"},
)
available = [m for m in res.json()["items"] if m["available"]]
{
"items": [
{ "method": "pix", "title": "Pix", "available": true, "minAmount": 100, "maxAmount": null },
{ "method": "card", "title": "Cartão de crédito", "available": true, "minAmount": 500, "maxAmount": 200000, "installments": 1, "holdDays": 15 },
{
"method": "crypto",
"title": "Cripto",
"available": true,
"minAmount": 200,
"maxAmount": 200000,
"currencies": [
{ "id": "ltc", "title": "Litecoin (LTC)" },
{ "id": "btc", "title": "Bitcoin (BTC)" },
{ "id": "eth", "title": "Ethereum (ETH)" }
]
}
]
}