Skip to main content

Prerequisites

Before you begin integration, ensure you have:

Authentication Credentials​

  • API Username & Password — issued by your Pagamio account manager. Used to obtain a Bearer access token via POST /auth/token. See Authentication.
  • Channel ID — your channel identifier. Find it in the Pagamio merchant dashboard under My User → Channels.
  • Active Merchant or Sub-Merchant Account — only Merchant and Sub-Merchant accounts can call /purchase. See Access & Permissions.
  • Activated Products — your account manager activates the products available to your merchant account. Confirm what's active via GET /merchants/{merchantId}/products (or GET /sub-merchants/{subMerchantId}/products). See Product Availability.

Development Environment​

  • Programming Language — any language with HTTP/REST support
  • Development Tools — IDE or text editor of your choice
  • API Testing Tool — Postman, Insomnia, cURL, or similar (recommended)

Network Requirements​

  • Internet Connection — stable internet connection
  • HTTPS Support — ability to make HTTPS requests
  • IP Whitelisting — whitelist Pagamio IPs (if applicable)
  • Firewall Configuration — ensure outbound HTTPS (port 443) is allowed

Business Requirements​

  • Registered Merchant Account — approved Pagamio merchant account
  • Configured Channel ID — active channel for transactions
  • Test Environment Access — sandbox credentials for development

Technical Knowledge​

  • Understanding of RESTful APIs
  • Basic knowledge of HTTP methods and status codes
  • JSON data format familiarity
  • Authentication concepts (Bearer tokens)