Getting StartedFirst Steps

Testing Connectivity

Verifying your connection to the PayOS API

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 your merchant profile, which verifies both your OAuth 2.0 access token and network connectivity:

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

Expected Response

If your connection is set up correctly, you should receive a response with your merchant profile details. Here’s what a successful response might look like:

1{
2  "status": "success",
3  "data": {
4    "merchant_id": "merchant_123456",
5    "name": "Bookstore Ltd.",
6    "industry": "Retail"
7  }
8}

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.