发送带支付验证的邮件

向监护人发送家长同意请求邮件，同时附上你的证明，表明已有成年人为其背后的购买完成了支付。除 `paymentVerification` 为必填外，与 `/challenge/send-email` 完全相同。若没有需要证明的支付，请改用该接口。仅当你的组织启用了 Transactions 能力时才会读取该证明，否则将被忽略。

Authorization

api-key

AuthorizationBearer <token>

In: header

Optional header for Account System Products to perform cross-product age gate checks. The value must be the product ID of the target product within the same organization. The target product must not itself be an Account System Product.

Request Body

application/json

Send email with payment verification request

TypeScript Definitions

Use the request body type in TypeScript.

challengeId*string

The ID of the challenge

Match^[A-z0-9]{8}-[A-z0-9]{4}-[A-z0-9]{4}-[A-z0-9]{4}-[A-z0-9]{12}$

Formatuuid

email?string

The email address of the parent or guardian. If omitted, the guardian on record for the challenge is used.

Formatemail

locale?string

The locale to use for the email using IETF BCP 47.

Match^[A-Za-z]{2,3}(-[A-Za-z0-9]+)*$

paymentVerification*

Your attestation that an adult completed a payment for this purchase through your merchant of record. k-ID neither processes nor witnesses the payment, so you are responsible for sending only real, completed payments.

k-ID carries the attestation into the parental-consent flow unchanged, as a signed claim on the challenge token, and decides there whether it satisfies consent. It never shortens or removes a step on its own: where the attestation does not qualify, the parent completes the standard parental-consent flow.

Describe the payment using k-ID's fields rather than your provider's; k-ID reads the same fields whichever provider you use.

Only read on a parental-consent challenge, and only when the Transactions capability is enabled for your organization. Otherwise it is ignored.

Response Body

`application/json`

curl -X POST "https://example.com/challenge/send-email-with-payment-verification" \  -H "Content-Type: application/json" \  -d '{    "challengeId": "ae6d4729-af32-42ea-8ef2-ff46c7664802",    "paymentVerification": {      "provider": "xsolla",      "invoiceId": "2110445753",      "payerEmail": "parent@example.com",      "instrument": "card",      "funding": "credit"    }  }'

{}

{  "error": "NOT_FOUND",  "errorMessage": "Challenge not found"}

发送带支付验证的邮件

Authorization

Header Parameters

Request Body

Response Body

200application/json

400application/json

Example Not found

Example Invalid email

Example Email mismatch

Example Approver required

`application/json`

`application/json`