Human Auth: Payment
Use this when an app requires payment card information for a purchase or subscription.
When to Trigger
- App shows a payment/checkout form asking for card details.
- App requests payment method during subscription signup.
How to Call
request_human_auth(
capability: "payment",
instruction: "Please enter your payment card details for [purchase description, amount].",
uiTemplate: {
fields: [
{ id: "card_number", label: "Card Number", type: "card-number", required: true },
{ id: "expiry", label: "Expiration", type: "expiry", required: true, placeholder: "MM/YY" },
{ id: "cvc", label: "Security Code", type: "cvc", required: true }
],
artifactKind: "payment_card",
requireArtifactOnApprove: true,
title: "Payment Card Required",
summary: "Enter your card details to complete payment."
}
)
After You Receive the Artifact
Read the artifact: read(<artifact_path>) to get card fields.
Check the current screen. The checkout form may still be visible.
If the form is visible: fill each field by tapping + typing (card number, expiry, CVC).
If the screen changed: navigate back to the checkout page.
Tap Pay / Submit / Complete Purchase.
Delete the artifact immediately: exec("rm <artifact_path>")
Tips
- Card number fields may auto-format. Type the full number without spaces.
- Expiry format: check the placeholder (MM/YY or MMYY).
1---2name: human-auth-payment3description: Handle payment card delegation from Human Phone. Covers credit/debit card number, expiry, CVC entry in checkout flows.4---56# Human Auth: Payment78Use this when an app requires payment card information for a purchase or subscription.910## When to Trigger1112- App shows a payment/checkout form asking for card details.13- App requests payment method during subscription signup.1415## How to Call1617```18request_human_auth(19 capability: "payment",20 instruction: "Please enter your payment card details for [purchase description, amount].",21 uiTemplate: {22 fields: [23 { id: "card_number", label: "Card Number", type: "card-number", required: true },24 { id: "expiry", label: "Expiration", type: "expiry", required: true, placeholder: "MM/YY" },25 { id: "cvc", label: "Security Code", type: "cvc", required: true }26 ],27 artifactKind: "payment_card",28 requireArtifactOnApprove: true,29 title: "Payment Card Required",30 summary: "Enter your card details to complete payment."31 }32)33```3435## After You Receive the Artifact36371. **Read the artifact:** `read(<artifact_path>)` to get card fields.38392. **Check the current screen.** The checkout form may still be visible.40413. **If the form is visible:** fill each field by tapping + typing (card number, expiry, CVC).42434. **If the screen changed:** navigate back to the checkout page.44455. **Tap Pay / Submit / Complete Purchase.**46476. **Delete the artifact immediately:** `exec("rm <artifact_path>")`4849## Tips5051- Card number fields may auto-format. Type the full number without spaces.52- Expiry format: check the placeholder (MM/YY or MMYY).