Register & log in

Three-step onboarding from zero to your first sandbox transaction.

Step 1 — Register

Self-service registration on the merchant dashboard.

• URL: dashboard.remittance.gofreshpay.com/register
• What you get:
  • merchant_code and merchant_secret (used for Basic auth on the API)
  • A sandbox account with a 1 USD transaction cap
  • Access to the merchant dashboard for wallet management, whitelist, callbacks
  • Access to this documentation site

Immediately after registration, log in and copy your merchant_code and merchant_secret into a secret store. The merchant_secret is shown once.

Step 2 — Log in (dashboard JWT)

POST /api/v1/merchant/login
Content-Type: application/json

{
  "email":    "you@example.com",
  "password": "…"
}

Response (200):

{
  "data": {
    "access_token": "eyJhbGciOiJI…",
    "merchant_code": "MKA-XXXX-XXXX",
    "company_name":  "Your Co Ltd",
    "role":          "OWNER",
    "environment":   "sandbox",
    "wallets": [ { "currency": "USD", "balance": 0, "reserved": 0, "available": 0 } ]
  }
}

Use the access_token as Authorization: Bearer <token> for dashboard endpoints only. For transaction-flow endpoints, keep using Basic auth with your merchant_code and merchant_secret.

Step 3 — Top up your wallet (sandbox)

Before you can send /inbound, your USD wallet must have credit. In sandbox we grant a symbolic top-up on request — email remittance-support@mokoafrika.com with your merchant_code.

Skip ahead

You can start reading the /inbound reference immediately even without wallet credit — the payload contract is the biggest surface area to understand.

First API call

Once your Basic auth credentials are in hand, test them with the free /health endpoint (no auth needed) and then /balance (Basic auth):

curl https://staging.remittance.gofreshpay.com/api/v1/remittance/health

curl https://staging.remittance.gofreshpay.com/api/v1/remittance/balance \
  -u 'MKA-XXXX-XXXX:sk_live_XXXXXXXX'

The /health returns {"status":"healthy","checks":{"database":"ok"}}. The /balance returns your live wallets.

Path to production

1. Certify against sandbox using the Postman collection (40+ tests).
2. Submit the Go Live request from the merchant dashboard: KYB documents + your production callback URL + IP whitelist.
3. Moko reviews the KYB (typically 1-2 business days).
4. On approval, you receive production merchant_code and merchant_secret and the amount cap is lifted.

Postman

Import the Postman collection and environment into Postman, fill 4 secrets, and run the collection folder by folder.