FAQ
Direct answers to what comes up most when building on Migo subscriptions. When something isn't supported we say so and offer the alternative.
Integration​
Do I need PCI certification?
No. With the payment link, card data is captured in the checkout
hosted by Migo; your server never sees it. You only need PCI scope if you choose to use your own form
with verify-card.
How many calls do I make per sale?
One: POST /transactions with customKeys.plan.uid. Migo does the rest.
Can I test without charging for real? Yes, sandbox is a full environment. Plans you create there do not migrate to production.
Can I reuse the same link for several customers? No. Each transaction is a single-use payment intent. Generate one per customer.
Plans​
Can I delete a plan?
There is no DELETE /api/v1/plans. Mark it in the name and filter it out in your application.
If I raise the plan price, do active subscriptions update? No. They keep their original price. To migrate them you must create a new plan and have the customer subscribe again.
Can I charge a discounted first month?
Yes, without touching the plan: the amount you send in the transaction is the first charge;
renewals use the plan amount.
Subscriptions​
Can I move a subscription from one plan to another? No. Cancel the current one and generate a link for the new plan.
Is there a free trial?
No. There is no trialing state. You can approximate it by charging a reduced first amount.
Can I pause and resume?
No. The states are active, inactive, cancelled and expired, and the last three are terminal.
Cancel and re-subscribe.
Can I reactivate a cancelled subscription? No. Create a new one with a new payment link.
How do I list all my merchant's subscriptions?
There is no endpoint that returns them all: GET /api/v1/subscriptions requires userId and
clientId. Keep your own customer index and iterate over it.
What if the customer cancels through their bank (chargeback)?
Migo does not propagate it as a state change. Charges will start failing and, once retries are
exhausted, the subscription becomes inactive.
Charges and notices​
How do I know a charge succeeded? Through the callback. The browser redirect is not a confirmation.
Am I notified of cancellations?
No. The callback only emits active and inactive. To detect cancelled and expired, poll
GET /api/v1/subscriptions/detail/{subUid} with a scheduled job.
Can the callback arrive more than once?
Yes, and you should treat that as normal: if you don't answer 2xx, Migo retries. Your handler must
be idempotent.
Can I replay a callback I missed? There is no on-demand replay. That's why periodic reconciliation against the API isn't optional.
Are there refunds on a subscription? Not from this API. See Voids & Refunds.
Related​
- The AI agent guide has the full flow with replay payloads and an acceptance checklist.
- Error catalog
- Contact