마카롱 페이먼츠 API 데모

API 연동을 테스트하고 웹훅을 확인할 수 있습니다

🎮 사용 가이드
아래 단계를 순서대로 따라하면서 API를 테스트해보세요

Step 1: 토큰 발급

먼저 “토큰 발급” 버튼을 클릭하여 API 액세스 토큰을 받으세요. 이후 모든 API 호출에 자동으로 사용됩니다.

Step 2: 입금 요청

사용자 ID와 금액을 입력하고 입금 요청을 생성하세요. 2분 후 자동 매칭이 시작됩니다.

Step 3: 출금 요청

출금 정보를 입력하여 입금과 매칭시키세요. 같은 금액이면 즉시 매칭되고, 다르면 부분 매칭이 발생합니다.

Step 4: 웹훅 확인

매칭 후 2분 뒤 오른쪽 패널에서 웹훅을 실시간으로 확인할 수 있습니다.

💡 팁: 입금 10,000원 + 출금 10,000원으로 시작하면 즉시 매칭을 확인할 수 있습니다. 부분 매칭을 테스트하려면 입금 5,000원 2건 + 출금 10,000원으로 시도해보세요. 웹훅 로그에서 “OCR 탭에서 사용” 버튼을 클릭하면 matchId가 자동으로 입력됩니다.

1. API 토큰 발급
사이트 ID와 Secret으로 액세스 토큰을 발급받으세요
2. 입금 요청 생성
사용자의 입금 요청을 생성합니다
웹훅 수신
연결 끊김
백엔드 관리자 페이지에서 사이트의 웹훅 URL을 이 주소로 설정하세요. 매칭 완료 후 2분 뒤 웹훅이 발송됩니다.
{
  "type": "MATCH_NOTIFICATION",
  "matchId": "cm5abc...",
  "amount": 50000,
  "depositRequest": { ... },
  "withdrawalRequest": { ... },
  "matchedAt": "2025-10-11T10:00:00.000Z"
}
수신된 웹훅이 없습니다