Skip to main content

Environments

Last updated: 2026-05-04

The API is available in separate environments. Use the base URL assigned to your integration.

Typical base URLs:

  • Development: https://merchants-api.payli.dev
  • Production: https://merchants-api.tcpay.io

All endpoints are relative to the base URL and start with:

  • /merchant/api/v1/...

Use Coverage for the product market list. Available countries, currencies, and method families are enabled per environment and merchant account.

Start discovery with these endpoints:

  • GET /merchant/api/v1/catalog
  • GET /merchant/api/v1/payins/banks
  • GET /merchant/api/v1/payins/mmo
  • GET /merchant/api/v1/payouts/banks
  • GET /merchant/api/v1/payouts/mmo

Call GET /merchant/api/v1/catalog first to retrieve the markets enabled for your account. Then call the bank and operator discovery endpoints for the country, method, and request context you plan to use. Use Payment methods, Mobile money, and Flows to build the final request shape for your integration.

The API accepts customerSegment on payout discovery requests for request consistency. Use the same segment value in discovery and creation when your integration classifies customer traffic by segment.

Non-production environments also expose POST /merchant/api/v1/payment/{id}/simulate for test payment status transitions. Do not build production payment flows around this endpoint.