Read-only endpoints to validate amounts and infer payment routing before money moves.
Try in API Reference: Amount & fees · MMO provider · Card provider · Source amount & fees
Common calls
| Endpoint | Purpose |
|---|
GET /v1/predictions/mmo-provider-info | Map phone → method + provider for MoMo |
GET /v1/predictions/card-provider-info | Validate card routing from Stripe payment_method_id |
GET /v1/predictions/amount-and-fees | Fee breakdown for a specific amount |
GET /v1/predictions/payment-source/amount-and-fees | Fees for a published invoice or order |
Mobile money detection
curl "https://api.heydollr.app/v1/predictions/mmo-provider-info?phone=231771234567&operation_type=COLLECTION" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
payment_method and gateway_provider when creating payment accounts.
Card provider info
curl "https://api.heydollr.app/v1/predictions/card-provider-info?payment_method_id=pm_xxx&operation_type=COLLECTION&provider=STRIPE" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
brand, country, currencies, and routing metadata. See Collect with card.
Amount and fees
curl "https://api.heydollr.app/v1/predictions/amount-and-fees?base_amount=250&base_currency=USD&target_currency=USD&payment_method=MTN_MOMO_LBR&operation_type=COLLECTION&provider=PAWAPAY&fee_bearer=PAYER" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
owner_type (USER, MICRO_ORGANIZATION, ORGANIZATION) and owner_id for merchant-specific tier pricing.
Payment source fees
For a published invoice or order:
curl "https://api.heydollr.app/v1/predictions/payment-source/amount-and-fees?source_type=INVOICE&source_id=101&target_currency=USD&payment_method=CREDIT_CARD&provider=STRIPE" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Last modified on June 23, 2026
