Descripción general
La API de Forma de Pago (Card FOP) admite pagos que se realizan mediante estándar. Pueden ser tarjetas de crédito o débito. Hay una de dos mensajes 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 reservas
El flujo de captura de reserva es un flujo de dos mensajes en qué fondos se reservan y, luego, se captan. Durante la reserva no se produce ningún movimiento de dinero. La reserva se puede cancelar o capturar. El el resultado final de la captura o la cancelación se envía 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 reserva, consulta este guía detallada.
Flujo de transferencia de fondos
El flujo de transferencia de fondos es un flujo de mensajes único en
qué fondos se captan directamente. El flujo se compone de un único método que
la implementa el integrador de pagos llamado Capture. Este método
de forma síncrona, comprueba si hay fondos disponibles y los capta si se realiza correctamente.
El integrador de pagos implementa
Google implementa
Para obtener más información sobre la transferencia de fondos, consulte este guía detallada.
Flujo de reembolso
El flujo de reembolso se usa para devolver los fondos que se capturada a través del flujo de captura de reserva o 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.
Flujo de disputas
El flujo de impugnación. se utiliza para informar a Google sobre disputas y devoluciones del cargo en las que el cliente solicita un reembolso. No todas las llamadas implica movimiento de dinero, pero este flujo puede utilizarse para devolver fondos a un cliente, o revertir esa acción y devolverla a Google. Este flujo puede usarse en además del flujo de denuncia de fraudes, pero no incluyen necesariamente el fraude.
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 fraude tiene el objetivo de informar a Google sobre de posibles fraudes. Esta información no implica ningún movimiento de dinero y se para informar sobre el evento al motor de riesgos de Google para evitar que se produzcan puede reducirse. Esto puede estar acompañado de una disputa o devolución del cargo a través de la flujo de impugnación.
Google implementa
Para obtener más información sobre informes de fraudes, consulta este guía detallada.