구현
보안
보안을 보장하기 위해 엑솔라는 다음을 사용합니다:
알림
API 키는 엑솔라 측에서 생성하며 각 공급자마다 고유합니다.
헤더
엑솔라에서 수신되는 요청에는 다음 헤더가 포함됩니다:
| 헤더 | 설명 | 필수 |
|---|---|---|
Request-Id | 고유한 요청 ID. | 예. |
Content-Digest | 요청 본문의 체크섬 값. | 요청 본문이 있는 경우 예. |
Signature-Input | 서명을 생성하는 데 사용되는 매개 변수. | 예. |
Signature | 서명 요청. | 예. |
Prefer | 추가 데이터(예: environment=“sandbox”). | 아니오. |
알림
엑솔라로 전송되는 웹훅에 동일한 헤더를 반드시 포함해야 합니다.
수신 요청 검증
엑솔라에서 요청을 수신할 경우:
Signature-Input헤더에서keyid값에 해당하는 기밀 키를 추출합니다.created/expires시간 창을 검증합니다.- 요청 본문을 검색합니다.
Signature-Input에 따라 서명 문자열을 다시 구성하고 HMAC-SHA256울 사용하여 서명을 확인합니다.
Copy
- http
1sig1=("@method" "@target-uri" "content-digest" "request-id");alg="hmac-sha256";created=1700000000;expires=1700000600;keyid="acc_123"
Request-Id를 사용하여 로그에서 요청을 검색합니다.
필수 기능
성공적인 통합을 위해서는 최소한 다음과 같은 API 메서드를 구현해야 합니다:
| 메서드 | 경로 | 설명 |
|---|---|---|
| POST | /v1/payments | 결제를 생성합니다. action 개체를 반환합니다. |
| PATCH | /v1/payments/{transaction_id} | action.type=confirm이 반환되면 결제를 확인합니다. |
| GET | /v1/payments/{transaction_id} | 현재 결제 상태를 가져옵니다. |
payment.succeeded- 결제 성공payment.failed- 결제 실패payment.refunded- 환불
알림
API 메서드 및 웹훅에 대한 자세한 설명은 사양을 참조하십시오.
이 기사가 도움이 되었나요?
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.
