Integração de referência

cd examples/fake-store
npm install
cp .env.example .env   # preencha com as suas credenciais de sandbox
npm run dev            # http://localhost:3000

fake-store/
├── src/
│   ├── server.ts                     # Express + rotas estáticas
│   ├── routes/
│   │   ├── orders.ts                 # criar ordem a partir do carrinho
│   │   ├── cart.ts                   # carrinho
│   │   └── webhook.ts                # recebe notificações da FaciPay
│   ├── services/
│   │   ├── FaciPayService.ts         # token + createPaymentOrder + getOrder
│   │   └── OrderStatusService.ts     # transições de estado
│   ├── database/database.ts          # SQLite + statements
│   └── public/
│       ├── checkout.html             # SDK: generateButton + callbacks
│       ├── success.html  pending.html  pending-ref.html  cancel.html
└── .env.example

const accessToken = await this.getAccessToken();

const response = await fetch(`${this.apiUrl}/facipaypartner/createPaymentOrder`, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json; charset=utf-8',
    Authorization: `Bearer ${accessToken}`,
    'Accept-Language': 'pt',
  },
  body: JSON.stringify({
    externalTransactionId: data.orderId,
    clientId: newClientId,
    applicationUUID: this.publishableKey, // sem prefixo
    name: data.description,
    image: data.image,
    amount: data.amount,
    quantity: 1,
    additionalInfo: JSON.stringify({
      returnUrl: data.additionalInfo.returnUrl,
      cancelUrl: data.additionalInfo.cancelUrl,
      webhookUrl: data.additionalInfo.webhookUrl,
    }),
  }),
});

const res = await response.json();
return { referenceNumber: res.data.referenceNumber };

await facipay.generateButton({
  async createOrder() { /* POST /api/orders/create-from-cart → referenceNumber */ },
  async onApprove(data, actions) { /* sincroniza estado, redireciona */ },
  async onPending(data, actions) { /* mostra referência EMIS */ },
  async onClick(data) {
    facipay.button.addCustomerInfo({ name, phone });
  },
  options: faciPayConfig.options,
}).render('#facipay-checkout-button');

// Referências múltiplas (um item por linha do carrinho)
facipay.button.addAllPaymentReferences(cart.items.map(item => ({
  referenceNumber: String(item.id),
  referenceDescription: item.name,
  referenceAmount: item.price,
  referenceQuantity: item.quantity,
  referenceTotalQuantity: item.stock_quantity,
})));