Implementation
Overview
Geopagos provides a Terminals SDK designed to enable your application to accept payments using a physical device, including integration with MPOS card readers on mobile devices and installation on Android-based SmartPOS terminals.
Sequence diagram
This flow represents a generic way to perform an authorization.
the Mobile application backend can be provided by the implementor or Geopagos.
Sale
| Operation | Method | Endpoint | |
|---|---|---|---|
| Initialize | POST | /api/v4/payments/present | Documentation |
| Initialize (with Intent) | POST | /api/v4/payments/present/intents/{uuid} | Documentation |
| Initialize (without Geopagos BackOffice) | POST | /api/v4/payments/initialize | Documentation |
| Confirm | POST | /api/v4/payments/{reference_number}/confirm | Documentation |
Payment Initialization Options
Initialize: Standard payment initialization for general use cases.
Initialize (with Intent): Payment initialization specifically designed for Caja POS systems that require payment intent functionality. This endpoint requires a payment intent UUID as a path parameter and provides enhanced integration capabilities for point-of-sale applications.
Refund
| Operation | Method | Endpoint | |
|---|---|---|---|
| Initialize | POST | /api/v4/refunds/present | Documentation |
| Confirm | POST | /api/v4/refunds/{reference_number}/confirm | Documentation |
More information
Supported devices:
See the API Reference for detail information about the integration.
For details of the implementation of the Readers SDK per platform see: