Skip to main content
Migo Docs

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.