Desde la cuenta corporativa hasta el seguimiento de gastos.
API organiza la operación corporativa en recursos separados, manteniendo cuentas, portadores, tarjetas, compras, facturas y análisis dentro del mismo contrato público.
Cuenta, saldo y límite.
Consulte el estado de cuenta, disponibilidad y solicite cargos límite.
Portadores y tarjetas.
Crea portadores, emita tarjetas virtuales o físicas y aplica reglas de uso.
Compras, facturas y análisis.
Seguir los gastos, los centros de coste, las facturas y los grupos analíticos.
Estatus de la cuenta de empresa
La activación no se realiza por el API público. El punto final GET /corporate/cards/account El Tribunal de Justicia de la República Federal de Alemania, en el caso de los Estados miembros, podrá solicitar la autorización de la Comisión para que se presente la situación actual del recurso.
No se ha solicitado activación.
El contrato actualizado debe ser aceptado en la Cuenta IOPAY.
Solicitud en análisis por parte del equipo IOPAY.
Operaciones de la API disponibles.
suspended Indica una fuente de recurso no disponible para la cuenta.Flujo básico
Confirme que el recurso está active.
Definir la identidad, el límite, el intervalo y el centro de costo.
Selección de tipo, límite y restricción de establecimiento cuando corresponda.
Utilice compras, facturas, centros de costo y análisis.
Crear portador
{
"name": "NOME HOLDER",
"tax_id": "12345678909",
"amount": 1000,
"interval": "month",
"center_cost": "MeuCenterCost"
}Crear una tarjeta
{
"holder_id": "{{holder_id}}",
"name": "Google Ads",
"limit": 100000,
"interval": "month",
"type": "virtual",
"merchant": "GOOGLE"
}merchant define una restricción de establecimiento, no el nombre de la tarjeta. Utilice name como una identificación interna. No hacer uso merchant o enviar null no define restricción por este campo.Recursos y puntos de referencia
| Área | Las operaciones | Ruta principal |
|---|---|---|
| Cuenta | Estatus, saldo, límite y recarga. | /corporate/cards/account · /balance · /recharge |
| Titulares | Enumerar, consultar, crear, actualizar y cancelar. | /corporate/cards/holders |
| Carnetos por portador | Revisar tarjetas y compras de un titular. | /holders/{holder_id}/cards · /purchases |
| Tarjetas | Enumerar, consultar, crear, actualizar y consultar datos sensibles. | /corporate/cards · /{card_id}/secrets |
| Compras | Lista general y por tarjeta/portador. | /corporate/cards/purchases |
| Centros de coste | Gastos agrupados y detalles del centro. | /corporate/cards/cost-centers |
| Facturas | Listar, cambiar el vencimiento y generar pago. | /corporate/cards/invoices |
| Los análisis | Resumen y agrupación de gastos. | /corporate/cards/analytics |
Límites, portadores y centros de coste
Limitación por regla general.
El titular recibe amount y intervalo day, week o month.
Virtual o físico.
Asociar la tarjeta al portador y definir límite, intervalo y restricción de comerciante cuando sea necesario.
Contexto para la operación.
Agrupa los gastos y consulta compras, valores y reembolsos por centro de costo.
Recursos y páginas
Las respuestas exitosas identifican el recurso por resource. Las listas utilizan un envólogo estandarizado con items, limit, total, offset, has_more y query_count.
{
"resource": "list",
"sort": "time-descending",
"items": [],
"limit": 100,
"total": 0,
"offset": 0,
"has_more": false,
"query_count": 0
}limit y offset se apoyan en las listas El límite estándar es 100 y el máximo es 1000 En consultas compatibles ?refresh=true actualizar la base IOPAY con los datos más recientes del banco emisor antes de la respuesta.Invocos y análisis de gastos
Ganada y pago.
Lista las facturas, configure el día de vencimiento entre 1 y 28 y gestiona datos de pago, que pueden incluir: brcode y link.
Gastos consolidados.
Consulte el total de gastos, cantidad de compras, cashback y agrupaciones por categoría, centro de costes, portador y evolución mensual.
Datos de la tarjeta
El punto final GET /corporate/cards/{card_id}/secrets devuelve PAN, CVV, validez y TTL cuando sea necesario para la operación.
Colección pública
La colección reúne los 23 puntos finales documentados, ejemplos de éxito y errores para flujos de cuenta, recarga, portadores y operación relevantes.