PayStar API Documentation
  1. PAYSATR FEATURES | EN
  • PAYSTAR PRODUCTS
    • GATEWAY QUALITY INDEX (GQI)
    • DIRECT CONNECT
    • PAYSTAR CORE
  • PAYSATR FEATURES | EN
    • Deposits section in PayStar
    • Unified audit log
    • Payment Form Analytics
    • Payment Analytics
  • PAYSTAR FEATURES | RU
    • Депозиты в PayStar
    • Единый журнал событий
    • Аналитика по платежам
    • Аналитика платёжной формы
  • Merchant API DOC | EN
    • Introduction
    • Glossary
    • Authorization key
    • Sandbox
    • Additional fields
    • Currencies
    • Bank names
    • Telecom operators
    • Callbacks
    • Error descriptions
    • Tech FAQ
    • Events
    • Payment history v2
      • Payment history - backward compatibility (legacy `X.Y.Z.W`)
    • Integratins
      • Stripe
      • Inwizo
      • 2Checkout
      • Adyen
      • AffiniPay
      • Alikassa
      • AlliancePay
      • Amazon Pay
      • AnyMoney
      • AstroPay
      • Aureavia
      • AurisMyChanger
      • Authorize.Net
      • Avatarix
    • Balance H2H
      GET
    • Deposit H2H - Card & P2P
      POST
    • Deposit H2H - Token
      POST
    • Deposit H2C - Card
      POST
    • Deposit status H2H - PayStar ID
      GET
    • Deposit status H2H - Merch ID
      GET
    • Payout H2H
      POST
    • Payout status H2H - PayStar ID
      GET
    • Payout status H2H - Merch ID
      GET
  • Schemas
    • Sample Schemas
      • Pet
      • Category
      • Tag
  1. PAYSATR FEATURES | EN

Payment Analytics

How to understand where conversion “hurts” in 5 minutes#

image.png
Imagine a typical morning: support says “payments aren’t going through”, marketing is stressed, and the chat is full of screenshots.
The Payments report exists exactly for this moment — so you don’t guess, but quickly localise the issue down to a gateway/channel/integration and make a decision.

1) Where to start: 3 switches that solve most cases#

image.png

Period and aggregation#

Date → select the range.
Day / Week / Month → choose the “zoom”.
Day is for operations, Week/Month is for trends.

By count vs By amount#

By count — how many attempts.
By amount — how much money (turnover).
Important: in By amount mode everything is converted to the Base currency. This makes comparisons consistent.

Direction#

All / Deposits / Payouts
Sometimes “everything looks fine” until you switch to payouts — and that’s where the surprise is.

2) How to read any “Distribution …” widget in 10 seconds#

Any widget = two halves:
donut — “who takes how much” (shares for the period),
line — “what changed” (trend).
If the donut says “everything is on one gateway” and the line shows rising errors — that’s almost a diagnosis.

3) The main screen: what to check first#

3.1 Status distribution — “is the patient alive?”#

image.png
This is your traffic light:
Success — blue
Failed — red
Processing/Created — yellow (if it gets stuck — bad)
Guidelines:
success should be stable (more important than “high once”)
Processing/Created usually trends to ~0 by end of day (unless you have long async flows)
Warning signals:
Success drops by ~3–5 pp+ vs your usual level
a Processing/Created “tail” persists for several days
First action: narrow down with filters Gateway → Integration → Channel.

3.2 Gateway distribution — “who is most likely responsible”#

image.png
Guidelines:
concentration >70–80% on one gateway (if you have an alternative) = risk
quality must be monitored per gateway
Warning signals:
GW Failed spikes on one gateway
traffic “shifts” to another gateway without a planned reason
Action: filter by gateway → review Channel and Integration.

3.3 Channel distribution — “where exactly it leaks”#

image.png
Channels often show degradation earlier than other dimensions.
Warning signals:
one channel turns “red” while the overall level still looks OK
a channel suddenly gets much more traffic (traffic shift)
Action: filter by channel → check Integration and Gateway.

3.4 Integrations — “did a specific key/endpoint die?”#

image.png
Warning signals:
an integration moves into Failed or stops receiving traffic
a high contribution to GW Failed
Action: filter by integration → check funnels + settings/limits/keys.

3.5 Pipelines — “is routing doing what you expect?”#

image.png
Warning signals:
one pipeline suddenly “ate” the traffic and conversion dropped
a new pipeline appears with a noticeable share (without “yes, we enabled it”)
Action: verify changes in rules/limits/provider availability.

3.6 Merchants and currency — “local or systemic issue?”#

image.png
image.png
Sometimes the issue is only for one merchant. Sometimes only for one currency.
Action: narrow by merchant/currency and repeat the check: gateway → channel → integration.

4) Funnels: where conversion is lost by stage#

Negative payment funnel — “where we fail”#

image.png
If GW Failed grows, it’s almost always “gateway/method/limits/anti-fraud”.
Action: Gateway → Integration → Channel, watch the trend and correlate it with traffic shifts.

Positive payment funnel — “where we don’t reach success”#

image.png
Path: PS Created → GW Created → GW Success
Guidelines:
PS Created → GW Created is typically ~98–100% (if there’s no reason to not send to the gateway)
the main “battle” is usually GW Created → GW Success
Diagnosis:
drop before GW Created — usually pre-gateway issues (routing/validation/infrastructure)
drop on GW Success — usually gateway/method/channel issues

5) The 5-minute “combat” algorithm#

1.
Open Status distribution → confirm the drop is real.
2.
Switch By count ↔ By amount → what matters more: “units” or “money”?
3.
Narrow down: Gateway → Integration → Channel → Pipeline.
4.
Check funnels → at which stage do we lose it?
5.
Capture: period, segment, trend — this is already a ready package for RCA (Root Cause Analysis).

6) Mini checklist for messaging gateway/PSP/bank support#

To get a faster answer, send:
period (UTC and local time if important)
segment: merchant/currency/direction
volume: count + amount
what degraded: Success/Failed and at which funnel stage
top offenders: gateway/integration/channel with most errors
screenshot/export from the widget (camera icon)

Terms (short)#

Payment — an attempt to execute a deposit/payout through a route and a gateway.
Pipeline — routing/processing scenario logic.
Channel — a specific route/segment inside a pipeline.
Integration — a specific gateway connection configuration.
Gateway — a bank or PSP.

Typical cases: what to do when “payments don’t go through”#

image.png
image.png
image.png
Below are the most common scenarios and fast actions in the report.

Case 1. GW Failed suddenly spiked (gateway-side failures)#

How it looks
GW Failed grows in the Negative funnel.
In Gateway distribution one gateway turns “red” or sharply increases its error share.
Likely causes
PSP/bank outage or degradation
Temporary restrictions/limits
Gateway-side anti-fraud blocks
Issues with a specific method/channel inside the gateway
What to do (step-by-step)
1.
Filter: Gateway = problematic.
2.
Open Integration distribution → see if one integration is dragging everything down.
3.
Open Channel distribution → identify whether one channel/method is broken.
4.
Switch By count ↔ By amount (sometimes only high-value traffic fails).
5.
Prepare an RCA pack: period, volume, GW Failed share, top channels/integrations.
Expected outcome
Issue localised to Gateway + (Integration/Channel).

Case 2. Conversion dropped but GW Failed barely changed#

How it looks
Success rate drops, but GW Failed in the Negative funnel doesn’t explain it.
In the Positive funnel, the drop is often before GW Created.
Likely causes
Payments don’t reach the gateway (validation/rules/routing)
Infrastructure issues: timeouts, queues, send failures
Errors at request creation/building stage
What to do
1.
Check the Positive funnel: do we drop on PS Created → GW Created?
2.
Filter by Pipeline, then Channel (often a specific routing condition).
3.
Compare “before/after” periods — were routing rules/limits changed?
4.
Check if Processing/Created increased (stuck states).
Expected outcome
A pre-gateway problem: routing/validation/infrastructure.

Case 3. Processing/Created tail doesn’t close#

How it looks
Processing (or Created) grows in Status distribution and stays as a “tail”.
Funnels show payments stuck between stages.
Likely causes
Final statuses are delayed/missing (callback/webhook), gateway delays
Issues processing statuses inside the platform
Queue/background job delays
What to do
1.
Narrow by Gateway → is it all gateways or one?
2.
Narrow by Integration → sometimes one endpoint doesn’t receive callbacks.
3.
Compare Day vs Week — systemic tail or one-off.
4.
If you have events/logs — verify callback delivery (report helps confirm the symptom).
Expected outcome
Either the gateway delays finalisation, or there’s an issue receiving/processing statuses.

Case 4. Drop only in one currency#

How it looks
In Currency distribution (or with a currency filter) Success is noticeably lower.
Other currencies are stable.
Likely causes
That currency uses a different method/gateway/channel
Acquiring/bank restrictions by country/currency
FX/limit specifics (especially in By amount mode)
What to do
1.
Filter: Currency = problematic.
2.
Immediately check Gateway → Channel → Integration (the “culprit” is usually there).
3.
Compare direction Deposits/Payouts (sometimes only payouts are affected).
Expected outcome
Problem in a specific currency routing bundle.

Case 5. Drop only for one merchant#

How it looks
In Merchant distribution one merchant degrades.
Overall system looks fine.
Likely causes
Merchant has dedicated pipelines/channels/gateways
Merchant configuration changes (limits, parameters)
Traffic/audience changed unexpectedly
What to do
1.
Filter: Merchant = X.
2.
Then the classic chain: Gateway → Integration → Channel → Pipeline.
3.
Compare By amount vs By count — sometimes only “expensive” payments fail.
Expected outcome
Merchant-local issue or its routing.

Case 6. Traffic shift: shares changed sharply and quality dropped#

How it looks
Distributions show one gateway/channel sharply increased its share.
At the same time Success drops and Failed grows.
Likely causes
Primary gateway went down and traffic moved to backup
Routing rules were changed
Limits/max-share kicked in (or provider limits)
What to do
1.
Identify the moment of change from the trend.
2.
Narrow to the new “main” gateway/channel → check its conversion.
3.
Check why traffic left the previous route (availability/limits/errors).
Expected outcome
Not “everything got worse”, but “traffic moved to a weaker route”.

Case 7. By count is fine, but By amount drops (or the opposite)#

How it looks
By count is stable, but By amount turnover drops (or vice versa).
Likely causes
High-value payments fail (limits, anti-fraud, 3DS checks)
Average ticket changed / traffic mix changed
Currency/base-currency conversion effects
What to do
1.
Compare By count vs By amount for the same segment.
2.
Narrow by Channel (high-value traffic often uses a dedicated route).
3.
Check currency and direction.
Expected outcome
Issue is in the “amount segment”, not overall volumes.

Case 8. Numbers “don’t match” between widgets#

How it looks
Small total differences between widgets or lists.
Likely causes
Some payments don’t have a value for a dimension yet (channel/integration not set)
Payments didn’t reach the funnel stage being counted
Different aggregation windows/filters
What to do
1.
Re-check active filters and date range.
2.
Reduce the period to 1 day and compare again.
3.
Filter by a single status (e.g., only Success) — differences often disappear.
Expected outcome
A data/stage nuance, not a report “bug”.
Previous
Payment Form Analytics
Next
Депозиты в PayStar
Built with