API
Skip to main content

Initiation

PayPay offers two payment terminal (POS/TPA) solutions to accept in-person payments: Standalone and Cloud.

Both solutions allow you to accept card payments securely and integrated with the PayPay backoffice.

Quick Comparison​

FeatureStandaloneCloud
ConfigurationPlug & PlayRequires API integration
Manual value entryYesNo (via API)
Software integrationOptional (webhook)Complete (API + webhook)
Backoffice synchronizationYesYes

Standalone Terminal​

Autonomous solution ideal for businesses that need a quick and simple way to accept payments.

When to use:

  • Physical stores without an integrated management system;
  • Points of sale that only need to process payments;
  • Businesses that value simplicity and speed;
  • Businesses that do not require integration with external software.

Features:

  • Plug & play setup: no technical configuration required;
  • Automatic real-time synchronization with the PayPay backoffice;
  • Optional webhook for transaction notifications;
  • Fully autonomous operation;
  • Ideal for quickly starting to accept payments.

Cloud Terminal​

Advanced solution for businesses that need full integration between terminals and management systems.

When to use:

  • E-commerce with a physical store that requires omnichannel integration;
  • POS systems that need to initiate payments remotely;
  • Invoicing software with integrated payments;
  • Restaurants with order management systems;
  • Full automation of sales and payment processes.

Features:

  • Remote communication with the terminal to initiate a transaction (no manual entry of amount);
  • Real-time bidirectional synchronization;
  • Webhook for automatic transaction confirmation in your system;
  • Full integration with third-party software;
  • Ideal for automation and an optimized user experience.

Supported methods on both terminals​

  • Contactless: Bring the card or mobile device close to the terminal.
  • Chip: Insert the card with chip.
  • Magnetic stripe: Swipe the card (where applicable).

Payment flow on the terminal​

1. Card Presentation​

When the operator enters the amount to be paid on the terminal (for standalone terminals) or sends the remote request to the terminal (for cloud terminals), the customer must:

  1. present the card using one of the following methods:
    • Contactless: Bring the card or mobile device close to the terminal.
    • Chip: Insert the card into the terminal.
    • Magnetic stripe: Swipe the card.
  2. The terminal reads the card data.

2. Authentication​

Depending on the amount and the type of card, authentication may be required:

  1. The card data is read by the terminal.
  2. The system checks whether authentication is required:
    • If yes: The customer enters the PIN.
      • If the PIN is correct: proceed with authorisation.
      • If the PIN is incorrect: retry or cancel (max. 3 attempts).
    • If not: Direct processing for authorisation.

Authentication types:

  • PIN: For transactions above the contactless limit.
  • Signature: For some card types (less common).
  • No authentication: For low-value contactless payments.

3. Processing and Authorisation​

The terminal communicates with the payment network to authorise the transaction:

  1. Data validated on the terminal (secure and encrypted connection);
  2. The terminal sends the request to the payment network;
  3. The network contacts the issuing bank for validation;
  4. The bank checks available funds and card limits;
  5. The response is sent back to the terminal:
    • Approved: Transaction authorised and debit completed.
    • Declined: Error message displayed.
information

The authorisation process usually takes 2–5 seconds.

4. Confirmation and Receipt​

After authorisation, the payment is completed:

  1. Transaction approved by the bank;
  2. The transaction is automatically synchronised in real time with the PayPay backoffice;
  3. PayPay checks that the webhook is configured:
    • If yes: The notification is sent to the external system.
    • If not: The transaction is only visible in the backoffice.

Next Steps​

Contact the team at @apoio for acquisition and consult the following steps: