Documentation Index
Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
Use this file to discover all available pages before exploring further.
개요
디지털 파일 전달은 디지털 파일 권한 유형입니다. 파일을 한 번 디지털 파일 권한에 업로드하고, 해당 권한을 제품에 첨부한 후, Dodo Payments가 모든 결제 고객에게 이메일과 고객 포털을 통해 서명된 다운로드 링크를 제공합니다. 권한은 다음을 지원합니다:- 호스팅된 파일 업로드: Dodo Payments에 파일을 저장하고 단기 서명된 URL을 통해 제공.
- 외부 다운로드 링크: Dropbox, Google Drive, S3 또는 다른 URL에 호스팅된 파일 링크.
- 다운로드 지침: 고객 주문 페이지와 배달 이메일에 표시되는 자유 형식 텍스트.
주요 기능
파일(PDF, ZIP, 이미지, 비디오 등)을 최대 100MB까지 업로드 가능합니다. 파일은 효율적으로 스트리밍되고 저장됩니다. 하나의 권한에 필요한 만큼의 파일을 첨부하십시오. 외부 다운로드 링크(Dropbox, Google Drive, 서명된 S3 URL)를 대안 또는 추가 사항으로 제공하십시오. 호스팅된 파일은 단기 서명된 URL을 통해 제공됩니다. 각 다운로드 URL은 대략 15분 후 자동으로 만료됩니다.디지털 제품 전달 설정
Dodo Payments 대시보드에서 권한으로 이동하여 **+**를 클릭하여 새 권한을 생성합니다. 디지털 제품 전달을 통합으로 선택합니다. 다음 중 하나 이상의 조합으로 설정하십시오:- 파일: 하나 이상의 파일을 업로드합니다. 각 업로드는 권한에 추가되는
file_id를 반환합니다. - 외부 URL: 호스팅된 파일과 함께 배달되는 공개적으로 접근 가능한 HTTPS 링크.
- 지침: 고객에게 표시되는 자유 형식 텍스트(예: “압축을 풀고 setup.sh를 실행”).
제품에 첨부
제품을 열고 Advanced Settings → Entitlements & Credits를 확장하여 디지털 파일 권한을 선택하십시오. 이 권한은 해당 제품과 연결된 모든 성공적인 구매 또는 활성 구독에서 제공됩니다.
배송 작동 방식
디지털 파일 전달은 표준 권한 수명 주기를 따릅니다:| 이벤트 | 동작 |
|---|---|
payment.succeeded (일회성) | 권한 발급. 권한은 대략 15분간 유효한 서명된 다운로드 URL을 제공합니다; 고객은 이메일 링크나 고객 포털 페이지를 다시 열어 새로 고침할 수 있습니다. |
subscription.active | 권한 발급. 파일은 구독이 활성화된 동안 접근 가능합니다. |
subscription.renewed | 무위. 동일한 권한이 계속되고, 새로운 서명된 URL은 매번 가져올 때 생성됩니다. |
subscription.on_hold / cancelled / expired | 권한 회수. 새로운 서명된 URL은 더 이상 발급되지 않습니다. |
subscription.plan_changed | 오래된 권한을 회수하고, 새 계획의 권한을 위한 새 권한을 발급합니다. |
refund.succeeded (일회성) | 권한 회수. |
| 수동 회수 | revocation_reason: manual로 회수. |
고객 경험
구매 확인
성공적인 거래 후, 고객은 다운로드 링크와 설정한 지침이 포함된 이메일을 받습니다.
고객 포털 접근
고객은 고객 포털에서 언제든지 다운로드 링크를 다시 가져올 수 있습니다. 포털 페이지는 요청 시 새 서명된 URL을 생성하므로, 동일한 구매가 이메일 링크가 만료된 후에도 계속 작동합니다.
프로그램 방식으로 파일 관리
권한에 파일 업로드
권한 및 다운로드 URL 목록
권한에서 파일 제거
중요 고려 사항
- 서명된 URL은 빠르게 만료됩니다. 권한 페이로드나 웹훅 이벤트에서 반환된 다운로드 URL은 약 15분 동안 유효합니다. 저장하지 마십시오; 고객이 다운로드가 필요할 때 다시 가져오십시오.
- 파일 업데이트는 미래 구매에만 영향을 미칩니다. 파일을 교체하거나 제거해도 이미 발급된 다운로드는 소급해서 변경되지 않습니다. 과거 고객은 그들의 권한이 생성되었을 때 현재 버전을 여전히 다시 가져올 수 있습니다.
- 환불은 이미 다운로드한 사본을 무효화하지 않습니다. 이미 파일을 다운로드한 고객은 그 사본을 유지합니다. 회수 가능한 콘텐츠(라이선스 제한 미디어, 시간 제한 접근)를 위한 경우, 디지털 파일을 라이선스 키와 결합하고 런타임에 검증하십시오.
- 민감한 콘텐츠의 경우 자체 인증이 있는 외부 URL을 선호하십시오. Dodo Payments의 서명된 URL은 단기적이지만, 해당 창 내에서는 인증이 없습니다; URL을 가진 누구나 그 창 내에서 다운로드할 수 있습니다. 외부에 호스팅되고 계정으로 게이트된 콘텐츠가 더 강력한 보장을 제공합니다.
API 관리
외부 URL 및 지침이 선택적으로 포함된 디지털 파일 권한을 생성합니다. 파일(최대 100 MB)을 업로드하고 권한에 추가합니다. 권한에서 파일을 제거합니다. 권한 목록을 작성하고 해결된 다운로드 URL을 읽습니다. 지침, 외부 URL 또는 파일을 업데이트합니다. 고객의 접근을 수동으로 회수합니다.웹훅
디지털 파일 전달 및 회수는 네 가지entitlement_grant.* 웹훅 이벤트를 발생시킵니다. 디지털 파일 권한의 경우, 페이로드에는 해결된 파일 목록(서명된 URL, 파일 이름, 크기), 선택적 instructions, 그리고 선택적 external_url가 포함됩니다.
레거시 디지털 제품 전달
프로덕트 자체의 오래된digital_product_delivery 블록으로 구성된 제품은 자동으로 마이그레이션되어 디지털 파일 권한으로 전환되었습니다. 레거시 제품 파일 API 아래 업로드된 기존 파일은 보존되며, 권한 페이로드에 표시되고, source: "legacy"로 태그가 붙은 상태로 계속 다운로드 가능합니다. 향후 업데이트(파일 추가, 지침 변경, 외부 URL 변경)는 권한에서 마이그레이션된 디지털 파일 권한을 편집하여 수행해야 합니다.
레거시 제품 수준의 필드(digital_product_delivery.external_url, digital_product_delivery.instructions)는 하위 호환성을 위해 여전히 제품 응답에 포함되지만, 앞으로의 참조 기준은 권한입니다.
모범 사례
- 다운로드는 일회성으로 취급하십시오. 고객은 링크를 공유하거나 잃어버릴 것입니다. 따라서 다운로드한 모든 것은 고객의 소유물이라고 가정하고 제품을 설계하십시오.
- 설명으로 기대를 설정하십시오. 다중 파일 번들의 경우, 처음 설치할 것 또는 파일 결합 방법을 설명하는
instructions라인을 추가하십시오. - 100MB 제한을 주의하십시오. 더 큰 아티팩트(기가바이트급 데이터셋, 비디오 코스)는 외부에 호스팅하고
external_url을 통해 링크해야 합니다. - 라이선스 키와 결합하여 접근을 철회하십시오. 환불 후 제품 기능에 대한 접근을 철회해야 하는 경우, 디지털 파일 권한을 라이선스 키 권한과 결합하고 런타임에 키를 검증하십시오.
- 고객 포털 새로 고침 흐름을 테스트하십시오. 고객이 일주일 후 포털로 돌아가 여전히 작동하는 다운로드 링크를 얻을 수 있는지 확인하십시오. 이것이 이메일 링크가 만료될 때 주요 복구 경로입니다.