Descripción general
La API de Card FOP (forma de pago) admite pagos que se realizan con tarjetas estándar. Pueden ser tarjetas de crédito o débito. Se proporciona un flujo de mensaje único y uno doble para los pagos.
Conceptos importantes
Símbolos y convenciones
Las palabras clave “DEBE”, “NO DEBE”, “OBLIGATORIO”, “DEBERÁ”, “NO DEBERÍA”, “DEBERÍA”, “NO DEBERÁ”, “RECOMENDADO”, “PUEDE” y “OPCIONAL” de estos documentos se deben interpretar como se describe en RFC 2119.
Marcas de tiempo
Todas las marcas de tiempo se representan como milisegundos desde el tiempo Unix en UTC.
Por ejemplo:
- 14 de agosto de 2010 16:30:00.00 a.m. GMT = 1281803400000
- 6 de noviembre de 2007, 9:37:00 p.m. (MST) = 1194410220000
Importes
Los valores monetarios de esta API se representan con un formato llamado "micros", un estándar de Google. Los micros son un formato de precisión fija basado en números enteros. Para representar un valor monetario en micros, multiplica el valor de moneda estándar por 1,000,000.
Por ejemplo:
- USD 1.23 = 1230,000 microUSD
- USD 0.01 = 10,000 microUSD
Idempotencia
Todas las llamadas de método dentro de esta API deben tener un comportamiento idempotente. En pocas palabras, los integradores no deben intentar volver a procesar ninguna solicitud que ya se haya procesado de forma correcta; en su lugar, se debe informar la respuesta para el procesamiento correcto. Todos los métodos tienen un RequestHeader en común que contiene un requestId. Este requestId es la clave de idempotencia para todas las llamadas.
En el caso de cualquier respuesta que no sea terminal (una respuesta que no sea HTTP 200), no se debe procesar de forma idempotente. Por lo tanto, una solicitud que antes obtuvo un 400, cuando se la llama por segunda vez, no debe mostrar 400 de manera idempotente, debe volver a evaluarse. En la reevaluación, podría mostrar un 400 o procesarse de forma correcta.
Para obtener más información sobre la idempotencia, consulta esta guía detallada.
Flujo de captura de reserva
El flujo de captura de reserva es un flujo de dos mensajes en el que primero se reservan los fondos y, luego, se capturan. Durante la reserva, no se produce ningún movimiento de dinero. La reserva se puede cancelar o capturar. El resultado final de la captura o cancelación se muestra de forma asíncrona a Google a través de una notificación.
El integrador de pagos implementa
Google implementa
captureFundsReservationResultNotificationcancelFundsReservationResultNotificationsetAcquirerReferenceNumberForCaptureNotification
Para obtener más información sobre la captura de reservas, consulta esta guía detallada.
Flujo de transferencia de fondos
El flujo de transferencia de fondos es un flujo de mensaje único en el que se capturan los fondos directamente. El flujo se compone de un único método que implementa el integrador de pagos llamado Capture. Este método verifica de forma síncrona los fondos disponibles y, si se realiza correctamente, capta los fondos.
El integrador de pagos implementa
Google implementa
Para obtener más información sobre la transferencia de fondos, consulta esta guía detallada.
Flujo de reembolso
El flujo de reembolso se usa para devolver los fondos que se capturaron antes a través del flujo de captura de reservas o el flujo de transferencia de fondos.
El integrador de pagos implementa
Google implementa
Para obtener más información sobre los reembolsos, consulta esta guía detallada.
Proceso de impugnación
El flujo de impugnación se usa para informar a Google sobre impugnaciones y devoluciones de cargos en las que el cliente solicita un reembolso. No todas las llamadas implican movimientos de dinero, pero este flujo se puede usar para devolver los fondos a un cliente o revertir eso y devolverlos a Google. Este flujo se puede usar como complemento del flujo de denuncia de fraudes, pero no necesariamente incluye fraudes.
Google implementa
Para obtener más información sobre las impugnaciones, consulta esta guía detallada.
Flujo de denuncia de fraudes
El flujo de denuncia de fraudes se usa para informar a Google sobre un posible fraude. Esta información no implica ningún movimiento de dinero y se usa simplemente para informar al motor de riesgos de Google sobre el evento, de modo que se pueda reducir el fraude general. Esto puede estar acompañado de una impugnación o devolución del cargo a través del flujo de impugnación.
Google implementa
Para obtener más información sobre la denuncia de fraudes, consulta esta guía detallada.