For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Log in to the PayOS Dashboard
GuidesAPI ReferenceHelp Center
GuidesAPI ReferenceHelp Center
  • Getting Started
    • Introduction to PayOS
    • Account Setup
    • Authentication
      • Testing Connectivity
      • Understanding Responses
  • Core Concepts
    • Webhooks
    • Merchant Location
  • Integration Guides
    • Hosted Checkout
    • Secure Fields (BETA)
    • Direct API Integration
  • Advanced Features
    • Recurring Payments (BETA)
    • Fraud Prevention (BETA)
    • Mobile Number Verification
  • Best Practices
    • Security Best Practices
    • Error Handling
    • Rate Limiting
Log in to the PayOS Dashboard
LogoLogo
On this page
  • Overview
  • Making a Test API Call
  • Using cURL
  • Expected Response
  • Troubleshooting Connectivity Issues
  • Contact Support
Getting StartedFirst Steps

Testing Connectivity

Verifying your connection to the PayOS API
Was this page helpful?
Edit this page
Previous

Understanding Responses

How to interpret responses from the PayOS API
Next
Built with

Overview

Testing connectivity to the PayOS API is a crucial step in ensuring that your application is properly integrated and ready for further development and deployment. This guide provides a method to verify your connection, emphasizing our enterprise-focused, white-glove onboarding approach.

Making a Test API Call

To test your API connectivity, you can make a simple API request to fetch your merchant profile or any other lightweight endpoint that requires OAuth 2.0 authentication.

Using cURL

Here’s an example using cURL to request payments, which verifies both your OAuth 2.0 access token and network connectivity:

$curl -X GET "https://api.payos.money/api/v1/payment" -H "Authorization: Bearer {your_access_token}"

Expected Response

If your connection is set up correctly, you should receive a json array response.

Troubleshooting Connectivity Issues

If you encounter issues, consider the following steps:

  • Verify Access Token: Ensure that your OAuth 2.0 access token is correct and has the necessary permissions.
  • Check Network Settings: Confirm that there are no firewalls or network policies blocking access to the PayOS API.
  • Use Diagnostic Tools: Tools like Postman or Wireshark can help diagnose connectivity or authentication issues.

Contact Support

If problems persist, contact PayOS support with details of your request and any errors you receive for further assistance. Our senior solutions engineers are available to provide personalized support and ensure your integration meets your business requirements.