Saltar al contenido principal
El SDK de JavaScript de PapelShip monta el formulario de tarjeta de PapelPay dentro de su propia página de checkout, para que el cliente nunca salga de su sitio. El formulario se carga en un marco servido por PapelShip: los datos de la tarjeta nunca pasan por su servidor ni por su página.

Antes de empezar

  • Inicie el pago con tarjeta en su servidor con POST /api/v1/invoices/{invoiceId}/papelpay y pase payment.embed_url a su página. Consulte Descripción general.
  • Agregue el dominio de su página de checkout en el panel, en PapelPay > Dominios, y verifíquelo. Un dominio personalizado verificado de su tienda también funciona, al igual que sus subdominios.
  • localhost y 127.0.0.1 funcionan sin configuración mientras desarrolla.
En un dominio no verificado, el marco muestra un aviso en lugar del formulario y onError recibe origin_not_allowed.

Montar el formulario

checkout.html
El marco crece y se reduce según su contenido. mount devuelve { iframe, destroy }; llame a card.destroy() para quitar el formulario, por ejemplo cuando el cliente elige otro método de pago.

Opciones

Eventos

Los mismos eventos están disponibles de forma global con PapelShip.on("papelpay:paid", fn), papelpay:declined, papelpay:error y papelpay:ready, y como CustomEvent papelship:papelpay:paid (y así sucesivamente) en window.

Confirmar el pago en su servidor

onPaid indica a su página que se cobró la tarjeta. Antes de entregar nada por su cuenta, confirme el pedido en su servidor: espere el webhook order.completed o consulte GET /api/v1/invoices/{invoiceId} y compruebe que status sea completed. Consulte Webhooks.
Permita las funciones de pago con tarjeta en el elemento padre del marco si usa su propio sandbox de iframe o política de permisos: el SDK define allow="payment *" en su marco para los pagos con billetera.