Authorize.Net 연결하기

필요한 것

필드	하는 일
API Login ID	API 호출에서 당신의 계정을 식별합니다. Transaction Key와 짝지어집니다.
Transaction Key	API 인증의 비밀 절반. Login ID와 함께 각 결제 양식을 발급합니다. 비밀.
Signature Key	웹훅이 정말 Authorize.Net에서 왔는지 확인합니다. Transaction Key와 별개. 비밀.
Success URL / Cancel URL	구매자가 결제 후 또는 빠져나간 뒤 도착하는 곳.

API Login ID와 Transaction Key는 항상 함께 다닙니다. Signature Key는 독립적입니다.

각 필드를 요청하는 이유

API 호출에서 당신의 계정을 지칭합니다. Transaction Key와 짝지어질 때만 작동합니다.

Transaction Key

API 요청이 당신의 것임을 증명하는 비밀. API Login ID와 함께 호스팅 결제 양식을 만들게 해, 청구가 당신의 계정을 통해 실행됩니다.

Signature Key

들어오는 웹훅이 진짜 Authorize.Net에서 온 것임을 증명해, 아무도 "결제됨" 이벤트를 위조할 수 없게 합니다. Transaction Key와는 별개의 값입니다.

Success and Cancel URL

단순한 설정: 구매자가 결제 후 또는 빠져나간 뒤 도착하는 곳. 비밀이 아닙니다.

설정

무료 샌드박스 계정 만들기 (결제 없음)
테스트에 유료 가맹점 계정이 필요하지 않습니다. Authorize.Net은 신용카드 없이 프로덕션을 그대로 본뜬 무료 샌드박스를 제공합니다.
1. developer.authorize.net/hello_world/sandbox.html로 가서 샌드박스 계정에 가입하세요. 메인 가입이나 가격 페이지(유료 라이브 신청)가 아니라 그 링크를 쓰세요.
2. sandbox.authorize.net에서 샌드박스 Merchant Interface에 로그인하세요.
서명 체계가 프로덕션과 동일하므로, 샌드박스에서 확인한 것은 라이브에서도 똑같이 동작합니다.
세 가지 자격 정보 복사하기
샌드박스와 라이브에서 같은 경로: Account → Settings → Security Settings → General Security Settings → API Credentials and Keys.
- API Login ID는 상단에 표시됩니다.
- Transaction Key: "New Transaction Key"를 선택하고 확인한 뒤 즉시 복사하세요(한 번만 표시됩니다).
- Signature Key: "New Signature Key"를 선택하고 확인한 뒤 곧바로 복사하세요.
Account → Settings → Security Settings → API Credentials and Keys
웹훅 추가하기
1. Account → Settings → Business Settings → Webhooks에서 엔드포인트를 추가하세요.
2. 엔드포인트 URL을 당신의 프로젝트 웹훅 주소(아래)로 설정하세요.
3. 이벤트를 구독하세요. 일회성 결제: net.authorize.payment.authorization.created, authcapture.created, capture.created, priorAuthCapture.created, refund.created, void.created, 그리고 fraud.* 이벤트(held, approved, declined). 구독(Automated Recurring Billing): net.authorize.customer.subscription.* 이벤트. 갱신은 authcapture.created로 도착하며 이미 다뤄집니다. 추가 이벤트는 무해합니다.
4. 저장하세요. Authorize.Net은 각 전달에 당신의 Signature Key로 서명합니다.
```
https://api.coinmoebius.com/webhook/authorizenet/<your project id>
```
Account → Settings → Business Settings → Webhooks
Coin Moebius는 각 이벤트 id를 한 번 기록하고 중복을 무시하므로, 재전송된 웹훅은 당신을 위해 처리됩니다.
샌드박스 카드로 테스트하기
샌드박스 카드는 실제 카드를 절대 청구하지 않습니다. 미래의 만료일(예: 12/2030)과 아무 CVV(3자리, American Express는 4자리)를 쓰세요.
네트워크 카드
Visa 4111111111111111
Mastercard 5424000000000015
American Express 370000000000002
Discover 6011000000000012
대시보드에서 연결하기
제공업체 추가 → Authorize.Net. Success URL, Cancel URL, 그리고 Live 그룹(API Login ID, Transaction Key, Signature Key)을 입력하세요. 테스트하려면 선택형 Sandbox 그룹을 추가하세요. Sandbox 그룹은 전부 아니면 전무입니다. 세 필드 모두이거나 하나도 없거나. 라이브와 샌드박스는 따로 확인됩니다.

네트워크	카드
Visa	4111111111111111
Mastercard	5424000000000015
American Express	370000000000002
Discover	6011000000000012

연결한 후

정식 오픈 전에 테스트 결제를 한 번 실행하세요:

상품을 만들고 Environment를 Testing으로 설정하세요. 그러면 상품이 당신의 샌드박스 자격 정보로 실행되어, 돈을 움직이지 않고 전체 주문을 넣을 수 있습니다. (샌드박스 세트를 건너뛰었다면 Testing 상품이 라이브로 폴백되니, 먼저 추가하세요.)
당신의 프로젝트를 가리키는 페이지(로컬 HTML 파일도 됩니다)에 구매 버튼을 두세요.
위의 샌드박스 테스트 카드로 결제를 완료하세요.
거래 탭을 여세요. Testing 태그가 붙은 새 행이 나타납니다. 상태가 succeeded에 도달하면, 당신의 자격 정보와 웹훅이 둘 다 처음부터 끝까지 작동하는 것입니다.

실제 결제 준비가 되면 상품 Environment를 Live로 전환하세요.

문제 해결

Verify로 시작하세요. 대시보드에서 Verify(또는 샌드박스 세트의 경우 Verify test credentials)를 클릭해 API Login ID와 Transaction Key를 확인하세요.

Verify가 실패합니다.

API Login ID와 Transaction Key는 같은 계정(라이브 또는 샌드박스)의 쌍이어야 합니다. 둘 다 다시 복사하세요.

서명 검증이 실패합니다.

Signature Key는 Transaction Key와 다른 값입니다. 같은 화면에서 Signature Key를 복사하세요. 체계는 샌드박스와 라이브에서 동일합니다.

결제는 완료되는데 주문이 대기 상태로 남습니다.

웹훅 URL이 정확히 일치하는지, 그리고 결제 이벤트를 구독했는지 확인하세요.

테스트 상품이 라이브 카드를 청구했습니다.

완전한 샌드박스 세트가 구성되지 않으면 테스트로 표시된 상품이 당신의 라이브 자격 정보로 폴백됩니다. 세 샌드박스 필드를 모두 추가하거나, 상품의 테스트 표시를 해제하세요.

처음부터 끝까지 확인하기.

Authorize.Net은 비활성 웹훅에만 핑을 보냅니다. 엔드포인트를 비활성으로 설정하고, 핑을 보낸 뒤, 다시 활성화하고, 주문이 업데이트되는 것을 지켜보세요.

알아두면 좋은 것

토큰은 수명이 짧습니다. 호스팅 양식 토큰은 약 15분 지속됩니다. 결제마다 새것을 발급합니다.

통화. Authorize.Net은 주로 미국 USD 게이트웨이입니다. USD 외 통화는 당신의 처리사 계약에 달려 있습니다.

키 교체. 새 Transaction Key나 Signature Key를 언제든 생성한 뒤 붙여넣으세요. 비밀 필드는 편집 시 비어 있습니다.

질문이 있으신가요? Join our Discord

Authorize.Net