API para desarrolladores
Integrar con Esquemas de URL
Inicia el pago de Stripe desde tu app o sitio web para procesar transacciones. Transfiere datos de clientes, importes e información del producto; luego, gestiona la devolución de llamada una vez finalizado.
Cómo funciona
Su aplicación abre una pago:// URL con parámetros
El pago por Stripe inicia y procesa la transacción
Al finalizar, la aplicación redirecciona a su URL de devolución de llamada con el resultado.
Puntos finales
Crear un cargo
payment://new?Procesar un pago único con monto, moneda y descripción.
Parámetros
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
amount | integer | Sí | Cantidad en centavos (por ejemplo, 1000 = $10,00) |
currency | string | No | Código de moneda ISO de tres letras (predeterminado: USD) |
description | string | No | Descripción del cargo codificada en URL |
customer | string | No | ID de cliente de Stripe existente |
email | string | No | Correo electrónico del cliente para el recibo |
name | string | No | Nombre del cliente codificado en URL |
metadata | string | No | Pares clave-valor personalizados (JSON codificado en URL) |
callback | string | No | URL a la que volver después de finalizar |
autoprocess | boolean | No | Omitir la pantalla de inicio y comenzar a cargar inmediatamente |
Crear una factura
payment://cart?Crea una factura de Stripe con artículos de línea de tu catálogo de productos.
Parámetros
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
prices | string | Sí | Identificadores de precios separados por comas con cantidades (p. ej., precio_abc:2, precio_xyz:1) |
customer | string | No | ID de cliente de Stripe existente |
email | string | No | Correo electrónico del cliente para el recibo |
name | string | No | Nombre del cliente codificado en URL |
callback | string | No | URL a la que volver después de finalizar |
Manejo de devoluciones de llamadas
Cuando se completa la transacción, Pago para Stripe redirecciona a su URL de devolución de llamada con parámetros de consulta que indican el resultado.
Parámetros de devolución de llamada
| Parámetro | Valores | Descripción |
|---|---|---|
status | success | error | cancelled | Resultado de la transacción |
charge_id | string | ID de cargo de Stripe (en caso de éxito) |
error | string | Mensaje de error (en caso de error) |
Ejemplos
Carga simple
Cobrar $10.00 con solo un monto
payment://new?amount=1000Cargar con descripción
Cobrar 25,00€ con una descripción
payment://new?amount=2500¤cy=eur&description=Coffee%20and%20pastryCargar con nuevo cliente
Cobrar $50.00 y crear un registro de cliente
payment://new?amount=5000&name=John%20Smith&[email protected]Cobrar a un cliente existente
Cobrar $75.00 a un cliente existente de Stripe
payment://new?amount=7500&customer=cus_ABC123xyzCargar con metadatos
Cobra $100.00 con metadatos personalizados para tus registros
payment://new?amount=10000&description=Invoice%20%231234&metadata=%7B%22order_id%22%3A%221234%22%2C%22location%22%3A%22Store%20A%22%7DProcesamiento automático con devolución de llamada
Omite la pantalla de inicio y regresa a tu aplicación cuando hayas terminado
payment://new?amount=3500&autoprocess=true&callback=myapp://payment-completeFactura con artículos de línea
Crea una factura con productos de tu catálogo de Stripe
payment://cart?prices=price_coffee:2,price_muffin:1&[email protected]Ejemplo completo
Todos los parámetros combinados para un flujo totalmente integrado
payment://new?amount=15000¤cy=usd&description=Service%20Fee&customer=cus_ABC123xyz&metadata=%7B%22invoice%22%3A%22INV-2024-001%22%7D&autoprocess=true&callback=myapp://payment-resultCodificación de URL
Recuerde codificar en URL los caracteres especiales en los valores de los parámetros. Los espacios se convierten en %20 y las llaves en %7B y %7D.
¿Listo para integrarse?
Descargue la aplicación y comience a probar su integración hoy mismo.