MobileTopup
가입하기

REST API v1

휴대폰 충전 API, 161개 나라 선불폰에 자동으로 보내요

내 서버나 앱, 쇼핑몰에서 통신사 552곳, 충전 상품 4,330개를 그대로 연결해요. 받는 금액보다 평균 35% 싼 MobileTopup 가격 그대로, 키 하나로 바로 시작해요.

무료로 가입하고 키 만들기회원 화면의 API 문서
주소
/api/v1
형식
JSON
인증
X-Api-Key
요청 제한
키마다 1분 300번

사업자를 위한 가장 저렴한 충전 API

화면과 같은 최저가

API로 보내도 가격은 똑같아요. 모든 상품이 받는 금액보다 30% 이상 싸고, 보낼 때 수수료가 없어요. 예: 필리핀 Globe 50 PHP는 가치 $0.78, API 가격 $0.54(30% 저렴).

심사 없이 바로 시작

가입하고 첫 크레딧 충전이 반영되면 회원 화면에서 키를 바로 만들어요. 계약서나 최소 물량이 없어요.

전 세계 한 번에

161개 나라, 통신사 552곳의 통화 충전과 데이터 요금제를 같은 방식으로 보내요.

중복 결제 걱정 없음

reference에 내 주문 번호를 붙이면 같은 요청이 두 번 와도 한 번만 결제하고 처음 결과를 돌려줘요.

실패하면 바로 반환

통신사가 받지 않은 충전은 결제 금액이 바로 크레딧으로 돌아오고, 바뀌지 않는 오류 코드로 알려 줘요.

영수증까지 같은 기록

API로 보낸 충전도 회원 화면 충전 내역에 영수증, 충전 코드, 통신사 참조 번호와 함께 남아요.

엔드포인트

나라, 통신사, 상품을 고른 뒤 충전을 보내고, 받은 충전 코드로 상태와 영수증을 확인하는 순서예요.

GET/v1/balance
GET/v1/countries
GET/v1/operators?country=PH
GET/v1/products?operator=PH-GB
POST/v1/recharges
GET/v1/recharges/{code}

시작하는 방법

  1. 1단계

    가입하기

    계정 토큰 하나로 가입해요. 이메일이나 서류가 필요 없어요.

  2. 2단계

    크레딧 충전하기

    USDT, USDC, BTC, ETH 등 12가지 방법으로 크레딧을 충전해요. 첫 크레딧 충전은 금액에 따라 보너스도 붙어요.

  3. 3단계

    API 키 만들기

    회원 화면의 API에서 키를 만들어요. 전체 키는 한 번만 보이니 서버 환경 변수에 바로 저장해요.

  4. 4단계

    충전 보내기

    X-Api-Key 헤더로 키를 보내고 POST /v1/recharges로 충전을 보내요.

충전 보내기 (cURL)

curl -X POST https://mobiletopup.io/api/v1/recharges \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone":"+639171234567","operator_id":"PH-GB","product_id":"ph-gb-a15c6dd","reference":"order-1042"}'

응답 (201)

{ "ok": true, "data": {
  "code": "RC-7KQ2-M9XD-4PWA", "status": "completed",
  "phone": "+639171234567", "operator_id": "PH-GB",
  "receive": "50 PHP", "price": "0.54", "currency": "USD",
  "reference": "order-1042", "duplicate": false
} }

휴대폰 충전 API FAQ

API는 누가 쓸 수 있나요?

MobileTopup 회원이면 누구나 쓸 수 있어요. 가입은 계정 토큰 하나로 1분이면 끝나고, 첫 크레딧 충전이 반영되면 회원 화면의 API에서 바로 키를 만들 수 있어요. 따로 신청하거나 심사를 기다릴 필요가 없어요.

API 가격은 화면과 같나요?

네, 완전히 같아요. 회원 화면의 충전 보내기와 같은 상품, 같은 가격, 같은 규칙이에요. 모든 상품이 받는 사람이 받는 금액보다 30% 이상, 평균 35% 싸고, 충전을 보낼 때 수수료가 붙지 않아요. 결제는 계정 크레딧에서 바로 돼요.

같은 주문이 두 번 결제되지 않나요?

충전 보내기에 내 주문 번호를 reference로 붙이면, 네트워크 문제로 같은 요청이 두 번 들어와도 한 번만 보내고 두 번째 요청에는 처음 충전 결과를 그대로 돌려줘요("duplicate": true).

요청 제한이 있나요?

키마다 1분에 300번까지 요청할 수 있어요. 넘으면 429와 Retry-After(초)가 와요. 대량 발송은 요청 사이에 간격을 두면 돼요.

충전이 실패하면 어떻게 되나요?

통신사가 충전을 받지 않으면 결제 금액이 바로 크레딧으로 돌아오고, 응답의 오류 코드로 알 수 있어요. 오류 코드는 바뀌지 않으니 코드로 처리하면 돼요.

키는 안전하게 보관되나요?

키는 해시로만 보관해서 만들 때 한 번만 전체가 보여요. 언제든 새로 발급하면 예전 키는 바로 멈추고, 키는 서버에서만 쓰도록 안내해요.

휴대폰 충전 API, 161개 나라 통화·데이터 충전 자동 발송 | MobileTopup