Bloque Payments SDK TS
Implementa integraciones de pago con los paquetes @bloque/payments, @bloque/payments-core y @bloque/payments-react.
Flujo recomendado
- Crear checkout en backend con
@bloque/payments. - Entregar
checkoutIdal frontend. - Montar checkout hosted con
@bloque/payments-coreo@bloque/payments-react. - Verificar webhooks en backend antes de procesar eventos.
Reglas de implementación
- Usar
accessTokenal inicializarnew Bloque(...). - Tratar el SDK de
@bloque/paymentscomo backend-only. - Verificar firma HMAC-SHA256 de webhooks con
bloque.webhooks.verify(...). - En frontend, usar
publicApiKey(noaccessToken). - Mantener
modeconsistente entre backend y frontend (sandboxoproduction).
Selección rápida de paquete
- Backend API de pagos:
@bloque/payments - Iframe hosted checkout (vanilla JS/TS):
@bloque/payments-core - Componente React para hosted checkout:
@bloque/payments-react
Referencias
references/quick-start.md: Arranque rápido backend + frontend.references/api-reference.md: Métodos, tipos y payloads principales.references/implementation-notes.md: Diferencias detectadas entre README y código fuente, con guardrails de uso.