시작하기
연동 / SDK
사용자 인증
기업 확인
거래 모니터링
변경 내역curl --request POST \
--url https://{issuer}/step-up/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"action": "payout",
"amount": "900.00",
"currency": "USD",
"return_to": "https://app.example.com/payouts/confirm"
}
'{
"required": false
}API 레퍼런스
스텝업 인증 생성 | Didit 인증 API
Didit의 POST /step-up/은 민감한 작업 전에 스텝업 규칙을 적용하고, required: false 또는 사용자용 인증 URL을 반환합니다.
POST
/
step-up
/
curl --request POST \
--url https://{issuer}/step-up/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"action": "payout",
"amount": "900.00",
"currency": "USD",
"return_to": "https://app.example.com/payouts/confirm"
}
'{
"required": false
}인증은 새로 추가된 기능입니다. 이 엔드포인트는
https://<name>.auth.didit.me와 같이 애플리케이션의 발급자가 제공하며, Didit API 키를 사용하지 않습니다.return_to에 있는 step_up 및 status 쿼리 파라미터는 애플리케이션이 확인해야 한다는 신호일 뿐입니다. 작업을 진행하기 전에 step-up 가져오기로 step-up을 조회하고, status가 approved인 경우에만 계속 진행하십시오.인증
POST /token/에서 반환된 해당 인물의 액세스 token입니다. 헤더가 typ: at+jwt인 ES256 JWT이며 최대 5분 동안 유효합니다. Didit API 키가 아닙니다.
본문
application/json
해당 사용자가 수행하려는 민감한 작업입니다.
payout(출금 또는 이체), bank(은행 계좌 추가 또는 변경) 또는 contact(이메일 또는 전화번호 변경). 출금에는 신규 기기 규칙도 적용됩니다.
사용 가능한 옵션:
payout, bank, contact 인증 후 사용자가 돌아가는 위치이며, step_up=<id>&status=approved가 추가됩니다. 규칙이 적용되는 경우 애플리케이션의 리디렉션 URI 중 하나여야 하며, 적용되는 규칙이 없으면 확인되지 않습니다.
Maximum string length:
2048예시:
"https://app.example.com/payouts/confirm"
payout에 필수: 금액(소수점 둘째 자리까지). JSON 숫자도 허용됩니다.
Pattern:
^[0-9]{1,16}(\.[0-9]{1,2})?$예시:
"900.00"
amount의 ISO 4217 코드입니다. 기본값은 지급 규칙의 통화입니다. 다른 통화로 지급되는 경우 항상 확인됩니다.
Pattern:
^[A-Z]{3}$예시:
"USD"
응답
적용되는 규칙이 없습니다.
적용되는 규칙이 없습니다. 작업을 진행하십시오.
사용 가능한 옵션:
false 마지막 수정일 2026년 11월 7일