위임 인증

가맹점에 로그인한 회원이 point3 결제창의 문자 인증 없이 결제하도록 합니다. 가맹점 서버가 회원 정보에 저장된 구매자 아이디(payerId)로 위임 인증을 생성해 결제창에 전달하면, 구매자는 문자 인증 없이 바로 결제를 진행할 수 있습니다. 자세한 내용은 위임 인증과 위임 인증 생성을 확인하세요.

위임 인증 생성

POST

https://api.point3.io

/authn/v2/delegation

로그인한 회원의 payerId로 위임 인증을 생성합니다. 응답의 authorization_url을 JavaScript SDK widgets()의 brandpay.redirectUrl로 전달하세요. 위임 인증은 300초 동안 유효하며 한 번의 결제창 실행에만 사용할 수 있습니다. 가맹점은 API 키로 식별하므로 요청 본문에 가맹점 정보를 넣지 않습니다.

위임 인증 생성 › 요청 본문

CreateDelegationRequest

payer_id

string · maxLength: 128 · pattern: ^payer: · 필수

로그인한 회원의 payerId입니다. 호출한 가맹점 소속의 활성 구매자여야 합니다.

예시: payer:00000000000000000000000000

위임 인증 생성 › 응답

위임 인증 생성 성공

CreateDelegationResponse

delegation_id

string · 필수

위임 인증 식별값입니다.

예시: dlg_3q2-7wE9bXk1Lr0Zt8pVnYc4uJmHs6aQfGdOiKe5NBw

expires_in

integer · 필수

위임 인증의 유효 시간(초)입니다.

예시: 300

authorization_url

string · uri · 필수

결제창에 전달할 URL입니다. 값을 바꾸지 말고 widgets()의 brandpay.redirectUrl로 그대로 전달하세요.

예시: https://auth.point3.io/delegated?delegation_id=dlg_3q2-7wE9bXk1Lr0Zt8pVnYc4uJmHs6aQfGdOiKe5NBw

결제 취소