API Documentation

Overview

Register an account and generate an API key from your dashboard to integrate automated top-up delivery directly into your own application, shop, or bot.

https://mail.aurponff.com/api

Authentication

Every request must include your api_key as a field in the request (JSON body for POST, query string for GET). Your key is issued automatically when you register and is visible on your dashboard.

{
  "api_key": "AMz-XXXXXXXXXXXXXXXXXXXXXXXX",
  ...
}

UniPin Voucher — Async

Redeems one or more UniPin voucher codes for a Free Fire player. Returns immediately with a "processing" status; the final result is POSTed to your url once it's ready. Send no package field — its absence is what tells the API this is a UniPin order.

curl -X POST https://mail.aurponff.com/api/topup \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "AMz-XXXXXXXXXXXXXXXXXXXXXXXX",
    "orderid": "order-001",
    "playerid": "123456789",
    "code": "BDMB-T-S-01234567 1234-5678-9012-3456",
    "url": "https://your-webhook.com/callback"
  }'

200 OK
{ "status": "processing" }

{
  "status": "success",
  "orderid": "order-001",
  "nickname": "PlayerName",
  "content": {
    "batch": [
      { "uc": "BDMB-T-S-01234567 1234-5678-9012-3456", "ok": true, "detail": "Success" }
    ]
  }
}

UniPin Voucher — Instant

Same as UniPin Async above, but synchronous — the final result comes back directly in this HTTP response. Do not send a url field, and don't send package — its absence marks this as a UniPin order.

curl -X POST https://mail.aurponff.com/api/topup-instant \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "AMz-XXXXXXXXXXXXXXXXXXXXXXXX",
    "orderid": "order-002",
    "playerid": "123456789",
    "code": "BDMB-T-S-01234567:1234-5678-9012-3456"
  }'

{
  "status": "success",
  "orderid": "order-002",
  "content": {
    "batch": [
      { "uc": "BDMB-T-S-01234567:1234-5678-9012-3456", "ok": true, "detail": "Success" }
    ]
  },
  "nickname": "PlayerName"
}

Garena Shell — Async

Purchases a Garena Shell package for a Free Fire player. Returns immediately with a "processing" status; the final result is POSTed to your url once it's ready. Sending a package field is what tells the API this is a Shell order.

curl -X POST https://mail.aurponff.com/api/topup \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "AMz-XXXXXXXXXXXXXXXXXXXXXXXX",
    "orderid": "shell-001",
    "playerid": "123456789",
    "code": "shell",
    "package": "lvl6",
    "username": "garena_username",
    "password": "garena_password",
    "url": "https://your-webhook.com/callback"
  }'

Garena Shell — Instant

Same as Shell Async above, but synchronous — the final result comes back directly in this HTTP response. Do not send a url field. If the provider is busy you'll get a 503 — fall back to /api/topup in that case.

curl -X POST https://mail.aurponff.com/api/topup-instant \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "AMz-XXXXXXXXXXXXXXXXXXXXXXXX",
    "orderid": "shell-002",
    "playerid": "123456789",
    "code": "shell",
    "package": "lvl6",
    "username": "garena_username",
    "password": "garena_password"
  }'

{
  "status": "success",
  "orderid": "shell-002",
  "content": {
    "batch": [
      { "package": "LVL6", "ok": true, "detail": "Success" }
    ]
  },
  "nickname": "PlayerName"
}

{
  "error": "Server busy — use /api/topup instead.",
  "code": "SERVER_BUSY"
}

Check Order Status

Query the status of a previously placed order by orderid or playerid. Doesn't count against your request limit.

curl -X GET "https://mail.aurponff.com/api/search?api_key=AMz-XXXXXXXXXXXXXXXXXXXXXXXX&orderid=order-001"

Shell Region & Package Codes

Response Values

A batch can also return an overall success, failed, or partial status — check each item's ok field individually when it's partial.