自动支付 SDK
官方的SDK da 免费付费 通过 临九 (原始内容存档于2013-10-12). de forma simples, segura e tollmente tipada.
欧 @abacatepay/sdk 额.. 包装版本ado de alto nível aPI da AbacatePay, focado em(英语:Focado em) 数字化, (中文(简体) ), 先输入脚本 电子 塞古兰察省。 。 。 .
Você poke ver 文档 ação completa do SDK 翻译 互联网档案馆的存檔,存档日期2013-10-02 亚基。 。 。 .
英斯特拉桑
使用 com o sue 软件包管理器 偏爱托
bun add @abacatepay/sdk
# ou
pnpm add @abacatepay/sdk
# ou
npm install @abacatepay/sdk
乌索·巴西克
import { AbacatePay } from '@abacatepay/sdk';
const abacate = AbacatePay({ secret });
Nunca使用 Sua API 关键 protamente no código. Sempre 使用 variáveis 环境。 。 。 .
克里亚多·乌马·科布兰萨
const checkout = await abacate.checkouts.create({
items: [
{
id: 'prod_123',
quantity: 1,
},
],
});
Procure por algons 客户端
const customers = await abacate.customers.list({
limit: 25,
email: 'maria',
});
太平洋岛国
Toda Listagem da v2 usa (英语) 光标{\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}反戈 {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}反戈 {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}再做一次 pagination: { hasMore, next, before }。 。 。 .
Páler a próxima página, 羡慕语 pagination.next 科莫语name after 爱丽瑟 null. Não defencea só de hasMore。 。 。 .
let after: string | undefined;
do {
const page = await abacate.checkouts.list({ limit: 100, after });
if (!page.success) break;
for (const checkout of page.data) console.log(checkout.id, checkout.status);
after = page.pagination.next ?? undefined;
} while (after);
托达斯作为列表também aceitam before, (中文(简体) ), startDate 电子 endDate (单位:千美元)YYYY-MM-DD{\fn华文楷体\fs16\1che0e0e0}请检查date=中的日期值 (帮助).
抽查透明
(原始内容存档于2017-03-26) (英语). Ottraão é sordizado no navegador pelo AbacatePay.js, que gera um token (单位:千美元)ctok_...维罗·乌尼科,válido por 60 segundos e criado para um valor(英语:amount) (中文(简体) ).
没有seu后端 cobre com card.create重头戏 cardToken (原始内容存档于2018-09-25) (英语). permane, que você pode guardar para cobrar o mesmo bartão de novo.
import { TransparentMethod } from '@abacatepay/types/v2';
const charge = await abacate.card.create({
amount: 15000,
token: 'ctok_...', // ou o cardToken de uma cobrança anterior, nunca os dois
installmentCount: 3, // opcional, de 1 a 12 (mínimo de R$10 por parcela)
customer: {
name: 'Maria Silva',
email: '[email protected]',
taxId: '529.982.247-25',
cellphone: '11999999999',
},
metadata: { orderId: 'pedido_123' }, // os valores precisam ser strings
});
if (charge.success) {
console.log(charge.data.id, charge.data.status, charge.data.cardToken);
}
// Consulte ou liste qualquer cobrança transparente (PIX, Boleto ou cartão); reembolse PIX ou cartão
await abacate.transparents.get(charge.data!.id);
await abacate.transparents.list({ method: TransparentMethod.Card });
await abacate.transparents.refund(charge.data!.id, 'Pedido cancelado');
调试 e 超时
请求 GET são repetidas automente em timeout e em moros timorários (408, 425, 429 e 5xx).
(原始内容存档于2013-10-29) (英语). Requisi'es que criam, enviam ou reemplersam dinheiro (英语)POST(中文(简体) ) 第429页:se uma cobrança de cartão, saque ou PIX der timeout, ela pode ter sido processada, então conference de antes de tentar de novo. 中国植物物种信息数据库.
(原始内容存档于2018-09-29). O Timeout paderão é 30 segundos.
const abacate = AbacatePay({
secret,
rest: { timeout: 60_000, retry: { max: 5 } },
});
MRR público(信任的MRR)
旋转 mrr.* {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}是的 {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}是的 {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}是的 {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}是的 mrr_ e e sess sord não funciona nas outras rotas. 中国植物物种信息数据库. 使用 um 客户端分隔 :
const mrr = AbacatePay({ secret: process.env.ABACATEPAY_MRR_TOKEN });
const { data } = await mrr.mrr.byDay({ startDate: '2026-01-01', endDate: '2026-01-31' });
版本纪念书
O pacote e focado 100% 纳 页:1 da API (英语:import { AbacatePay } from '@abacatepay/sdk') (中文(简体) ).
一分一秒,一分一秒 /v1马斯・埃斯塔 继续(sem novos recentos) apenas para quem ainda não migrou, e emite um aviso no core ao ser usada. 互联网档案馆的存檔,存档日期2013-12-02., p.
/** @deprecated Migre para a v2 (`@abacatepay/sdk`) */
import { AbacatePay } from '@abacatepay/sdk/v1'
const client = AbacatePay({ secret });
const { data, error, success } = await client.withdraw.create({
method: 'PIX',
externalId: 'trx_abc123',
...
});
错误的悲剧
(原始内容存档于2018-03-26). Nenhuma chamada do SDK lança exceção. Toda chamada 解决 com o mesmo 格式化 { data, error, success } 普罗普里(Própria API da AbacatePay) 重整旗鼓——包容性的falhas de rede/timeout são normalizadas para sesse formato pelo @abacatepay/rest。 。 。 .
const { data, error, success } = await abacate.subscriptions.create({ ... });
if (!success) {
console.error(error);
return;
}
console.log(data);
飞来飞去,飞来飞去
开源,德·维尔达德.