Skip to main content

Points of sale

Overview​

A point of sale (POS) represents a physical or virtual space where commercial transactions take place. Each point of sale serves as a central hub for payment execution and transaction management. The distinctive feature lies in the unique association between each point of sale and a specific QR code.

It is important to clarify that each point of sale can only have one QR code representing it. This ensures traceability and security in transactions. The exclusive QR code acts as an identifier for the point of sale and facilitates direct access to the necessary information for payment processing.

Furthermore, for the same point of sale, multiple static QR codes associated with specific amounts can be generated. In other words, these QR codes identify individual transactions. This strategy not only optimizes the efficiency of the payment process but also enhances security by ensuring that each transaction is directly linked to a specific point of sale.

In addition to the above, points of sale can also be used with SmartPOS devices, which allow payment intents to be sent from external software. In these cases, the SmartPOS device handles the card data reading directly on the terminal, completing the payment process.

Payment intents can be cancelled if they haven't been completed yet. This is useful when a customer decides not to proceed with the payment or when there are technical issues that prevent the payment from being processed.

For more information on how SmartPOS devices function and how to integrate them, refer to the SmartPOS section in the documentation. Additionally, for more details about QR codes, see the Types of QR codes section.

Cancel Payment Intent​

When a payment intent is created but needs to be cancelled (for example, if the customer decides not to proceed with the payment), you can use the cancel payment intent endpoint.

Request​

curl --location --request DELETE 'https://points-of-sale.qa.geopagos.cloud/api/v4/points-of-sale/{pos_uuid}/intents/{intent_uuid}' \
--header 'Authorization: Bearer {your_jwt_token}'

Parameters​

  • pos_uuid: The unique identifier of the point of sale
  • intent_uuid: The unique identifier of the payment intent to cancel

Response​

  • 204 No Content
  • 400 Bad Request
  • 404 Not Found

Example​

curl --location --request DELETE 'https://points-of-sale.qa.geopagos.cloud/api/v4/points-of-sale/d807441a-1e0f-48ea-9cc1-594decb4c29e/intents/c01758df-dd52-4f91-8095-50335824caf0' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'

Cancel Intents by POS​

When you need to cancel all pending payment intents associated to a specific point of sale, you can use the cancel intents by POS endpoint.

Request​

curl --location --request DELETE 'https://points-of-sale.qa.geopagos.cloud/api/v4/points-of-sale/{pos_uuid}/intents' \
--header 'Authorization: Bearer {your_jwt_token}'

Parameters​

  • pos_uuid: The unique identifier of the point of sale

Response​

  • 204 No Content
  • 400 Bad Request
  • 404 Not Found

Example​

curl --location --request DELETE 'https://points-of-sale.qa.geopagos.cloud/api/v4/points-of-sale/d807441a-1e0f-48ea-9cc1-594decb4c29e/intents' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'

Cancel Refund Pending by POS​

When you need to cancel all pending refunds associated to a specific point of sale, you can use the cancel refund pending by POS endpoint.

Request​

curl --location --request DELETE 'https://points-of-sale.qa.geopagos.cloud/api/v4/points-of-sale/{pos_uuid}/refunds/pending' \
--header 'Authorization: Bearer {your_jwt_token}'

Parameters​

  • pos_uuid: The unique identifier of the point of sale

Response​

  • 204 No Content
  • 400 Bad Request
  • 404 Not Found

Example​

curl --location --request DELETE 'https://points-of-sale.qa.geopagos.cloud/api/v4/points-of-sale/d807441a-1e0f-48ea-9cc1-594decb4c29e/refunds/pending' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'

Sequence diagram​

This diagrams represents the generic flow to create a point of sale.

Api reference​

See the points of sale section in Acceptor API for detail information about integration.