Saltar al contenido principal
Esta guía le acompaña a través de un pedido completo con la Store API de PapelShip: cree un pedido para uno de sus productos, envíe al cliente al checkout alojado y confirme el pago antes de darlo por válido.

Requisitos previos

  • Una tienda de PapelShip con al menos un producto
  • Una clave de Store API (pk_live_...) con el permiso orders:write, y el ID de su tienda para el encabezado x-store-hash
Encontrará ambos en el panel de PapelShip, en la configuración de API de su tienda. Consulte Autenticación.
1

Cree un pedido

Envíe el correo electrónico del cliente y los productos. Agregue un encabezado Idempotency-Key para que los reintentos nunca creen un segundo pedido.
2

Envíe al cliente al checkout

La respuesta contiene el pedido con su checkout_url. Redirija al cliente allí para que pague con cualquier método que acepte su tienda.
Respuesta (201)
Guarde invoice.id junto con su pedido. Los pedidos no pagados caducan después de 3 horas. Para cobrar una tarjeta de inmediato, o para mostrar el formulario de tarjeta en su propio sitio, consulte PapelPay.
3

Confirme el pago

Nunca confíe únicamente en que el cliente regrese a su sitio. Escuche el webhook order.completed o consulte el pedido desde su servidor:
El pedido está pagado y entregado cuando status es completed.
Mantenga su clave de API en su servidor. Nunca la incluya en código de navegador, aplicaciones móviles ni clientes de escritorio.

Próximos pasos

Pedidos

Productos físicos, estados, cancelación y reembolsos.

PapelPay

Pagos con tarjeta, suscripciones y el formulario de tarjeta en su sitio.