Developer documentation

Mainmoney payment links API

Sign in

Sandbox testing

API request

GET /developers/v1/sandbox/testing-guide

Fetch Mainmoney sandbox test cards and MoMo numbers (sandbox apps only).

curl -X GET "https://api.mainmoney.net/api/v2/developers/v1/sandbox/testing-guide" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Sandbox testing

Sandbox payment links run in Mainmoney test mode. No funds settle to your business wallet; webhooks and redirects behave like production.

  1. Create a Sandbox app in the developer dashboard.
  2. Call GET /developers/v1/config for methods and currencies.
  3. Call GET /developers/v1/sandbox/testing-guide for current test cards and MoMo numbers.
  4. Create a payment link and open the returned url.
  5. Complete checkout with test credentials or use simulate-complete for redirect-only tests.

Dashboard

The Testing page in the developer dashboard mirrors the testing-guide API for your active sandbox app.

API request

POST /developers/v1/payment-links/{id}/simulate-complete

Mark a sandbox payment as completed without a live acquirer call.

curl -X POST "https://api.mainmoney.net/api/v2/developers/v1/payment-links/plink_123/simulate-complete" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN"