Initiation

Cloud Terminal is an advanced solution that allows full integration between the payment terminal and the client system via REST API, enabling automation and remote control of transactions.

Integration Architecture

┌─────────────────┐      API REST       ┌──────────────────┐
│  Your System    │ ←─────────────────→ │   PayPay API     │
│  (POS/ERP)      │                     │                  │
└─────────────────┘                     └──────────────────┘
      ↑                                        ↓
      │                                   ┌────────────┐
      │          Webhook                  │  Terminal  │
      └───────────────────────────────────┤   Cloud    │
               (notification)             └────────────┘
                                                 ↕
                                          ┌──────────────┐
                                          │    Network   │
                                          │  Payments    │
                                          └──────────────┘

Common Troubleshooting

Problem	Probable Cause	Solution
The terminal does not respond	Terminal is offline or UUID is incorrect	Check the terminal connection and UUID
Webhook not received	Endpoint not configured or inaccessible	Check URL and firewall
Transaction declined	Check funds, card validity, or contact the issuing bank
The terminal does not respond	Check internet connection and restart the terminal
Printing error	Check paper and printer settings
Incorrect PIN	The customer can try again (maximum 3 attempts)

Next Steps

Explore the complete documentation for integration:

• Webhook Configuration - Notification configuration.
• Send Payment Request - Send a payment request to the cloud terminal.