Developer platform

La API es el núcleo.

La experiencia sigue siendo tuya.

Construye pagos directamente en tu producto. Una API REST para customers, tarjetas, Pix, boleto y crédito, con SDKs, webhooks y referencias dedicadas para Transaccional, Enlaces de Pago, Sellers, Split de pagos y Gestión de Gastos.

REST APIProducciónSandboxWebhooksTarjetas en hasta 21xPixBoletoTokenización y Compra con 1 ClicEnlaces de pagoSplit de pagos
Documentación IOPAY

APIs y referencias de integración documentadas y organizadas

Amplía productos y servicios de pago como servicio. Empieza por la API Base y avanza hacia la referencia específica de tu implementación. Transaccional, Enlaces de Pago, Sellers, Split de pagos, Consultas, Tokenización y Gestión de Gastos están organizados para que llegues rápido a la referencia correcta.

docs-api.iopay.com.br
Documentación pública
API Base

La base de tu integración.

Empieza por la autenticación, la configuración del entorno, customers, tarjetas y tokenización. La capa transaccional llega en la siguiente etapa.

FoundationAPI Base
AUTHBearer tokenAcceso
POST/api/v1/customer/newCustomer
POST/api/v1/card/tokenize/tokenTokenize
ENVsandbox / productionEntornos
API Transaccional

Del pago creado al ciclo completo de la transacción.

Concentra aquí las operaciones transaccionales de Pix, tarjeta y boleto: creación, consulta, captura, cancelación, reembolso y seguimiento de estado.

PaymentsAPI Transaccional
POST/api/v1/transaction/new/:CustomerIDCrear
GET/api/v1/transaction/get/:idConsultar
CAPcaptura total o parcialCaptura
VOIDcancelación / reembolsoCiclo
Postman · Payment Links API V2

Convierte un cobro en una URL.

La API V2 reúne la creación, consulta, actualización, eliminación y listado de enlaces, además de la consulta de las transacciones generadas. Configura artículos, medios de pago, cuotas, intereses, disponibilidad, Order Bump, identidad visual y Split cuando esté habilitado.

Configuración V2Payment Link
ITEMtitle + items[]Cobro
PAYcredit / pix / boletoMétodos
TIMEopen_at / end_at / max_paymentsDisponibilidad
CARDmax_installment + interestPago a plazos
BUMPorder_bump_items[]Oferta adicional
BRANDprimary_color + bannersIdentidad
SPLITsplit_rules[]Distribución
Postman · Sellers API

Participantes tratados como parte de la arquitectura.

Consulta la referencia específica para implementar recursos relacionados con los Sellers de la plataforma y mantener esa capa separada del núcleo transaccional.

Postman Public collection
Sellers APIparticipantes de la plataforma
Postman · Split de pagos

Split de pagos con referencia propia.

Usa la collection dedicada para implementar reglas de Split de pagos en operaciones con múltiples participantes, manteniendo esa capa separada de la API Base y de la API Transaccional.

Postman Public collection
Split de pagosreglas de Split de pagos
Gestión de Gastos & Tarjetas Corporativas

Control corporativo conectado a la plataforma.

Un frente dedicado a la emisión y gestión de tarjetas corporativas, la definición de límites, políticas de uso, titulares y el seguimiento de la operación de gastos.

CorporateTarjetas Corporativas
CARDemisión y gestión por empresaTarjetas
RULElímites y políticas de usoControl
TEAMtitulares y centros de costoEquipo
VIEWvisión consolidada de gastosOperación
Quickstart

De la primera request
al primer cobro.En tres pasos.

Configura la autenticación, crea el customer y genera un cobro Pix usando el mismo flujo que tu aplicación llevará a producción.

Paso01de 03 ·Autenticar requests
Paso 01 · Acceso

Autenticar requests

Toda integración comienza autenticando tus credenciales para obtener el token de acceso a la API.

Bearer TokenTransaction3600s
Qué hacer en esta etapa
  • Enviar email, secret e io_seller_id.
  • Recibir el access_token.
  • Usar el Bearer Token en las siguientes requests.
Entiende esta etapa
Objetivo
Tu aplicación empieza a comunicarse con la API IOPAY de forma autenticada.
Respuesta esperada
Un token de acceso para autenticar las siguientes requests.
Dónde encaja
Al inicio de la integración, antes de acceder a customers, tarjetas o transacciones.
Ejemplo de autenticación
Docs ↗

        
Respuesta de ejemplo · JSON
Paso siguiente

Con la autenticación lista, el siguiente paso es crear el comprador que recibirá el cobro.





Medios de pago

Una integración.Cada pago,
su propio recorrido.

Pix, tarjeta y boleto viven en el núcleo transaccional. Los Enlaces de Pago llevan la misma infraestructura a ventas asistidas, cobros remotos y canales sin checkout propio.

PIX

Pix

Creación de cobros instantáneos, código QR y seguimiento de la confirmación por evento.

Ideal para checkout, cobros remotos y flujos de pago inmediato.
CC

Tarjetas

Crédito al contado o a plazos, tokenización y recorridos de recompra o recurrencia.

Permite combinar checkout propio con los flujos de autorización de la operación.
BLT

Boleto

Emisión y seguimiento de cobros para recorridos que exigen pago por boleto.

El estado del cobro puede integrarse en los procesos internos de la empresa.
LNK

Enlaces de Pago

Crea cobros alojados y compartibles por API para vender fuera del checkout tradicional.

CRM, WhatsApp, inside sales, atención al cliente y recorridos asistidos.


Webhooks y eventos

Tu sistema no necesita preguntar.
Iopay avisa en segundos.

HTTP POST Tiempo real Sin polling

IOPAY recibe la actualización del pago, procesa el nuevo estado y envía el webhook a tu endpoint. Poca fricción, flujo claro y sistemas sincronizados.

Cuenta con la capa de webhooks y eventos resilientes de Iopay, con reenvío automático en caso de indisponibilidad de tu servidor.

01 · Origen El pago cambia.

Nuevo estado en la infraestructura.

→→→→→→→→→→→→→→
03 · Tu sistema El webhook llega. Siempre.

Tu endpoint recibe la request POST de Iopay y tú procesas y reaccionas como quieras. Tu sistema actúa tras un pago creado, aprobado, fallido, reembolsado o cancelado parcialmente. Con la confirmación, tu sistema tiene todo para liberar el pedido, alimentar CRM y ERPs, interactuar con SAP, integrar fulfillment y facturación.

SDKs IOPAY

SDKs para Java, Javascript, Node.js y
PHP / Laravel.

Usa los clientes públicos de IOPAY en Node.js y PHP / Laravel o integra directamente mediante la API REST en cualquier lenguaje. Menos boilerplate para empezar, sin perder acceso al contrato HTTP de la plataforma.

SDK oficial · Node.js

Integración lista para aplicaciones JavaScript.

Cliente público con autenticación, entornos, tokenización, customers y las principales operaciones transaccionales.

Instalación
npm install
@iopay-payments/iopay-api-sdk-nodejs

// depois, use o client IOPAY no projeto
SDK oficial · PHP

Composer para PHP o proyectos Laravel.

El paquete oficial iopay-payments/sdk-php puede instalarse mediante Composer y usarse a través del autoload del proyecto, incluso en aplicaciones Laravel.

Instalación mediante Composer
composer require
iopay-payments/sdk-php

// disponível no vendor/autoload.php do projeto
REST API · cualquier stack

Usa HTTP directo cuando quieras control total.

Python, Go, Java, .NET, Ruby o cualquier otro stack pueden consumir la API IOPAY directamente por HTTPS, usando los mismos endpoints y contratos publicados.

Ejemplo universal
curl --request GET \\
  --url https://api.iopay.com.br/api/v1/customer/get/:CustomerID \\
  --header 'Authorization: Bearer tu_token' \\
  --header 'Content-Type: application/json'
Operación

La integración y la operación tienen que hablar el mismo idioma.

Tras el deploy, ingeniería, producto, finanzas y atención al cliente necesitan ver el mismo pago. El portal IOPAY complementa la API con visión transaccional, cuentas por cobrar, credenciales, informes y seguimiento operativo.

01Transacciones Consulta estado, cliente, método, valor y referencias de la operación.
02Cuentas por cobrar Sigue la visión financiera asociada a las ventas procesadas.
03Credenciales Centraliza los datos necesarios para los entornos de integración.
04Informes Respalda las rutinas de operación y conciliación sin depender solo del equipo de ingeniería.
Operación IOPAYVisión consolidada
TRANSACCIONES883
APROBACIÓN60,4%
TPVR$ 2,58M
TransacciónMétodoEstadoValor
0b527...9a6creditAprobadaR$ 1.002
44d23...9044pixPendienteR$ 3.482
34fad...29e7creditAprobadaR$ 5.444
Seguridad & arquitectura como núcleo y principio fundacional

APIs y arquitectura pensadas para operar
pagos con control, seguridad y visión.

Las credenciales, la segregación de entornos, la tokenización y los controles de seguridad forman parte de la arquitectura del producto y reducen la exposición innecesaria de datos sensibles.

01Credenciales segregadas

Separa desarrollo, pruebas y producción con credenciales adecuadas a cada entorno.

02Tokenización

Reduce la circulación de datos sensibles en recorridos de recompra, recurrencia y one-click.

03PCI DSS 4.0.1

Controles de seguridad y protección del entorno de pagos aplicados a la infraestructura IOPAY.

04Eventos y trazabilidad

Usa identificadores, estados y webhooks para seguir el ciclo de la transacción y responder a excepciones.

Casos de uso

Arquitectura para distintos
modelos de negocio.

La Developer Platform IOPAY se diseñó para productos que necesitan incorporar pagos a su propia experiencia, del e-commerce al SaaS, marketplace, ERP y venta asistida.

E-commerce

Checkout propio.

Controla la experiencia del comprador mientras IOPAY ejecuta la capa de pagos y eventos.

Ver e-commerce →
SaaS & recurrencia

Recompra y cobro continuo.

Combina tokenización, customers, eventos y la lógica de tu aplicación para recorridos recurrentes.

Ver documentación →
Marketplaces

Sellers y Split de pagos.

Lleva el contexto de los Sellers y las reglas de Split de pagos al flujo de la transacción.

Ver marketplaces →
ERP & finanzas

Pagos conectados a la operación.

Integra cobros y eventos en los procesos internos de conciliación, atención y finanzas.

Hablar con un especialista →
Inside sales

Cobro dentro del embudo.

Genera enlaces o transacciones desde el CRM y devuelve el estado a ventas, onboarding y finanzas.

Ver enlaces →
White-label

Infraestructura bajo tu experiencia.

Combina APIs y recursos de plataforma para ofrecer recorridos de pago integrados con tu marca.

Ver white-label →
Integración y APIs IO

De la primera llamada a producción. Cuenta con la mejor arquitectura de soluciones de pago

Explora la documentación, prueba tu integración y lleva los pagos a tu producto con la infraestructura IOPAY.