SePay API Overview

Introduction to SePay API for querying transactions and bank account information.


  • SePay provides an API for you to proactively query transaction information, bank accounts, for reconciliation and detailed transaction lookup. If you want to receive real-time notifications from SePay, use webhooks.

What's New in v2

  • Unified JSON envelope response, UUID identifiers instead of numeric IDs
  • Standardized pagination (page/per_page), integer currency fields
  • Proper HTTP status codes for errors (401, 404, 422, 429)
  • Virtual Accounts API (new)

Details: Legacy API vs API v2 Comparison

SePay Bank Hub

If you want the bank connection steps to be performed on your software side, without users having to register an account at SePay, please refer to the SePay Bank Hub solution.

API Rate Limits

  • SePay limits API calls to a maximum of 3 requests/second/IP. Exceeding the limit returns HTTP 429 Too Many Requests.

Retry-After Header

  • When the limit is exceeded, the response includes headers Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
JSJavaScript
1
Retry-After: 1