Raw Card Data Access 활성화
Dodo Payments가 Adyen을 통해 결제를 라우팅하려면 Adyen 계정에 raw card data access가 필요합니다. Adyen은 PCI DSS를 준수하는 설정에만 이 권한을 활성화합니다. Dodo Payments가 사용자를 대신하여 raw card data를 처리하며 PCI DSS Level 1 compliant이므로, Adyen에 **Dodo Payments Attestation of Compliance (AOC)**를 제출하면 되고 자체 인증은 필요하지 않습니다.Dodo Payments PCI DSS Attestation of Compliance (AOC)
현재 Dodo Payments AOC를 다운로드하여 Adyen support에 제출하고 raw card data access를 활성화하세요.
필요한 항목
Settings → BYOP에서 Adyen을 연결하려면 Adyen Customer Area에서 다음 세 가지 값이 필요합니다.Adyen은 test (
ca-test.adyen.com) credential과 live (ca-live.adyen.com) credential을 별도로 관리합니다. 설정하려는 Dodo Payments mode와 일치하는 Customer Area에서 credential을 생성하세요.Step 1: API Key 생성
API key를 생성하려면 Customer Area에서 Manage API credentials 또는 Merchant admin role이 필요합니다.1
Open API Credentials
Adyen Customer Area에 로그인하고 Company 계정을 선택한 다음 Developers → API credentials로 이동하세요.
2
Select Your Credential
Payments 탭을 선택한 다음 credential username을 선택하세요.
ws_123456@Company.YourCompanyAccount와 같이 표시됩니다.3
Generate the Key
Server settings → Authentication에서 API key 탭을 열고 Generate API key를 선택하세요.
4
Copy It Immediately
복사 아이콘을 선택하고 key를 안전하게 보관하세요. 페이지를 벗어나면 다시 복사할 수 없습니다. 그런 다음 Save changes를 선택하세요. 새로 생성된 key는 즉시 활성화되며, 이전 key는 24시간 동안 계속 작동합니다.Dodo Payments에서 Secret Key field에 key를 붙여넣으세요.
Step 2: Merchant Account 찾기
merchant account는 Adyen이 거래를 처리하는 데 사용하는 account identifier입니다. Customer Area의 상단 account selector에 표시되며, 예를 들면YourCompany_ECOM와 같습니다.
identifier를 Dodo Payments의 Merchant Account field에 붙여넣으세요. 설정이 완료되면 merchant account가 안전하게 저장되며 변경할 수 없습니다.
Step 3: Webhook 및 HMAC Key 설정
Adyen connection을 저장하면 Dodo Payments가 Webhook Endpoint URL을 생성합니다. 이를 Adyen에 webhook으로 추가한 다음 HMAC key를 생성하세요. Merchant admin 또는 Merchant technical integrator role이 필요합니다.1
Create a Webhook
Customer Area에서 Developers → Webhooks로 이동하고 Create new webhook을 선택하세요. webhook type 목록에서 Standard webhook 옆의 Add를 선택하세요.
2
Configure the Webhook
- Description을 입력하세요.
- Enabled toggle을 켜세요.
- Server configuration에서 Dodo Payments가 생성한 Webhook Endpoint URL을 URL field에 붙여넣으세요. URL은 HTTPS를 사용해야 하며 public access가 가능해야 합니다.
3
Generate the HMAC Key
Security의 HMAC Key section에서 Generate를 선택하여 새 HMAC key를 생성하세요. key를 복사하여 안전하게 보관하세요. 나중에는 다시 복사할 수 없습니다. 그런 다음 Save configuration을 선택하세요.
4
Paste the HMAC Key into Dodo
Settings → BYOP에서 HMAC key를 Webhook Signing Secret field에 붙여넣은 다음 Save & continue를 선택하여 connection을 완료하세요.
Set up BYOP
전체 Bring Your Own Processor 설정 flow를 따르세요.
자주 묻는 질문
What is the HMAC key for?
What is the HMAC key for?
Adyen은 모든 webhook에 HMAC signature를 사용하므로 receiver가 notification의 integrity와 origin을 확인할 수 있습니다. Dodo Payments는 사용자가 제공한 HMAC key를 사용하여 Adyen account에서 전송된 webhook을 검증합니다.
I lost my API key or HMAC key, what now?
I lost my API key or HMAC key, what now?
둘 다 생성한 후에는 가져올 수 없습니다. HMAC key를 교체하려면 Adyen의 webhook settings에서 새 key를 생성하세요. 그런 다음 Settings → BYOP를 열고 Edit Configuration을 선택한 후 Adyen connection을 편집하고, Webhook Signing Secret에 key를 붙여넣은 다음 Save & continue를 선택하세요.API key를 교체하려면 Developers → API credentials에서 새 key를 생성하세요. Dodo dashboard에서는 저장된 secret key를 변경할 수 없습니다.
Do test and live use the same credentials?
Do test and live use the same credentials?
아니요. 일치하는 environment에서 credential을 생성하세요. test (
ca-test.adyen.com) 또는 live (ca-live.adyen.com) credential을 생성한 후 Dodo Payments에서 일치하는 mode로 설정하세요. 또한 test에서 live로 전환할 때 Adyen에서는 새 HMAC key가 필요합니다.