[{"data":1,"prerenderedAt":3615},["ShallowReactive",2],{"navigation-docs_v2":3,"\u002Fv2\u002Fmoney-in\u002Fcard-vault-charge":136,"\u002Fv2\u002Fmoney-in\u002Fcard-vault-charge-surround":3610},[4],{"title":5,"path":6,"stem":7,"children":8,"page":68},"V2","\u002Fv2","v2",[9,27,69,98,111,128],{"title":10,"path":11,"stem":12,"children":13},"Introduction","\u002Fv2\u002Foverview","v2\u002F1.overview\u002F1.index",[14,15,19,23],{"title":10,"path":11,"stem":12},{"title":16,"path":17,"stem":18},"Test Details","\u002Fv2\u002Foverview\u002Ftest-details","v2\u002F1.overview\u002F2.test-details",{"title":20,"path":21,"stem":22},"Errors","\u002Fv2\u002Foverview\u002Ferror-handling","v2\u002F1.overview\u002F3.error-handling",{"title":24,"path":25,"stem":26},"Migrate from V1","\u002Fv2\u002Foverview\u002Fmigrate-from-v1","v2\u002F1.overview\u002F4.migrate-from-v1",{"title":28,"path":29,"stem":30,"children":31,"page":68},"General","\u002Fv2\u002Fgeneral","v2\u002F2.general",[32,36,40,44,48,52,56,60,64],{"title":33,"path":34,"stem":35},"Lookups","\u002Fv2\u002Fgeneral\u002Flookups","v2\u002F2.general\u002F1.lookups",{"title":37,"path":38,"stem":39},"Customer portal Link","\u002Fv2\u002Fgeneral\u002Fcustomer-portal-link","v2\u002F2.general\u002F10.customer-portal-link",{"title":41,"path":42,"stem":43},"Payment Methods","\u002Fv2\u002Fgeneral\u002Fpayment-methods","v2\u002F2.general\u002F2.payment-methods",{"title":45,"path":46,"stem":47},"Customers","\u002Fv2\u002Fgeneral\u002Fcustomers","v2\u002F2.general\u002F3.customers",{"title":49,"path":50,"stem":51},"Bank Accounts","\u002Fv2\u002Fgeneral\u002Fbank-accounts","v2\u002F2.general\u002F4.bank-accounts",{"title":53,"path":54,"stem":55},"Cards","\u002Fv2\u002Fgeneral\u002Fcards","v2\u002F2.general\u002F5.cards",{"title":57,"path":58,"stem":59},"Mandates","\u002Fv2\u002Fgeneral\u002Fmandates","v2\u002F2.general\u002F6.mandates",{"title":61,"path":62,"stem":63},"Products","\u002Fv2\u002Fgeneral\u002Fproducts","v2\u002F2.general\u002F8.products",{"title":65,"path":66,"stem":67},"Transactions","\u002Fv2\u002Fgeneral\u002Ftransactions","v2\u002F2.general\u002F9.transactions",false,{"title":70,"path":71,"stem":72,"children":73,"page":68},"Money In","\u002Fv2\u002Fmoney-in","v2\u002F3.money-in",[74,78,82,86,90,94],{"title":75,"path":76,"stem":77},"Collections","\u002Fv2\u002Fmoney-in\u002Fcollections","v2\u002F3.money-in\u002F1.collections",{"title":79,"path":80,"stem":81},"Electronic Mandates","\u002Fv2\u002Fmoney-in\u002Felectronic-mandates","v2\u002F3.money-in\u002F2.electronic-mandates",{"title":83,"path":84,"stem":85},"Checkout Link","\u002Fv2\u002Fmoney-in\u002Fcheckout-link","v2\u002F3.money-in\u002F3.checkout-link",{"title":87,"path":88,"stem":89},"Checkout Form","\u002Fv2\u002Fmoney-in\u002Fcheckout-form","v2\u002F3.money-in\u002F4.checkout-form",{"title":91,"path":92,"stem":93},"Card Vault Link","\u002Fv2\u002Fmoney-in\u002Fcard-vault-link","v2\u002F3.money-in\u002F5.card-vault-link",{"title":95,"path":96,"stem":97},"Card Vault Charge","\u002Fv2\u002Fmoney-in\u002Fcard-vault-charge","v2\u002F3.money-in\u002F6.card-vault-charge",{"title":99,"path":100,"stem":101,"children":102,"page":68},"Money Out","\u002Fv2\u002Fmoney-out","v2\u002F4.money-out",[103,107],{"title":104,"path":105,"stem":106},"Payouts","\u002Fv2\u002Fmoney-out\u002Fpayouts","v2\u002F4.money-out\u002F1.payouts",{"title":108,"path":109,"stem":110},"Recipients","\u002Fv2\u002Fmoney-out\u002Frecipients","v2\u002F4.money-out\u002F2.recipients",{"title":112,"path":113,"stem":114,"children":115,"page":68},"Verification","\u002Fv2\u002Fverification","v2\u002F5.verification",[116,120,124],{"title":117,"path":118,"stem":119},"CDV","\u002Fv2\u002Fverification\u002Fcdv","v2\u002F5.verification\u002F1.cdv",{"title":121,"path":122,"stem":123},"AVS-R","\u002Fv2\u002Fverification\u002Favs-r","v2\u002F5.verification\u002F2.avs-r",{"title":125,"path":126,"stem":127},"SDO","\u002Fv2\u002Fverification\u002Fsdo","v2\u002F5.verification\u002F3.sdo",{"title":129,"path":130,"stem":131,"children":132,"page":68},"Webhooks","\u002Fv2\u002Fwebhooks","v2\u002F6.webhooks",[133],{"title":129,"path":134,"stem":135},"\u002Fv2\u002Fwebhooks\u002Fwebhooks","v2\u002F6.webhooks\u002F1.webhooks",{"id":137,"title":95,"body":138,"description":3604,"extension":3605,"links":3606,"meta":3607,"navigation":442,"path":96,"seo":3608,"stem":97,"__hash__":3609},"docs_v2\u002Fv2\u002F3.money-in\u002F6.card-vault-charge.md",{"type":139,"value":140,"toc":3585},"minimark",[141,146,155,162,167,176,221,225,228,303,307,310,380,384,387,920,924,941,1299,1303,1318,1321,1813,1816,2304,2325,2329,2631,2635,2646,2649,2655,2674,2678,3236,3240,3479,3483,3538,3542,3545,3570,3574,3581],[142,143,145],"h2",{"id":144},"request","Request",[147,148,149,150,154],"p",{},"Request to charge a customer's vaulted card(s). By default the customer's default card is attempted first, cascading through the remaining active cards in priority order until a charge succeeds or all cards are exhausted. Pass ",[151,152,153],"code",{},"card_id"," to charge a specific card only (no cascade).",[147,156,157,158,161],{},"Charges are processed as merchant-initiated transactions (MIT) — no 3DS challenge is presented. The 3DS authentication from the original card storage (see ",[159,160,91],"a",{"href":92},") provides the authentication reference for scheme compliance.",[163,164,166],"h3",{"id":165},"path","Path",[147,168,169,172,173],{},[151,170,171],{},"POST"," ",[151,174,175],{},"\u002Fcard-vault\u002F{customer_id}\u002Fcharge",[177,178,179,199],"table",{},[180,181,182],"thead",{},[183,184,185,190,193,196],"tr",{},[186,187,189],"th",{"align":188},"left","Path Parameter",[186,191,192],{"align":188},"Type",[186,194,195],{"align":188},"Description",[186,197,198],{"align":188},"Example",[200,201,202],"tbody",{},[183,203,204,208,211,218],{},[205,206,207],"td",{"align":188},"customer_id",[205,209,210],{"align":188},"String(32)",[205,212,213,214],{"align":188},"The customer whose stored cards will be charged — see ",[159,215,217],{"href":216},"\u002Freference\u002Fcustomers","customers",[205,219,220],{"align":188},"cus_abc123...",[163,222,224],{"id":223},"example-basic","Example (Basic)",[147,226,227],{},"Basic example to charge the customer. The default card is attempted first, then the remaining active cards in priority order.",[229,230,235],"pre",{"className":231,"code":232,"language":233,"meta":234,"style":234},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"amount\": \"349.00\",\n  \"reference\": \"INV-2026-00042\" \u002F\u002F your reference; appears on statements and reporting\n}\n","json","",[151,236,237,246,274,297],{"__ignoreMap":234},[238,239,242],"span",{"class":240,"line":241},"line",1,[238,243,245],{"class":244},"sMK4o","{\n",[238,247,249,252,256,259,262,265,269,271],{"class":240,"line":248},2,[238,250,251],{"class":244},"  \"",[238,253,255],{"class":254},"spNyl","amount",[238,257,258],{"class":244},"\"",[238,260,261],{"class":244},":",[238,263,264],{"class":244}," \"",[238,266,268],{"class":267},"sfazB","349.00",[238,270,258],{"class":244},[238,272,273],{"class":244},",\n",[238,275,277,279,282,284,286,288,291,293],{"class":240,"line":276},3,[238,278,251],{"class":244},[238,280,281],{"class":254},"reference",[238,283,258],{"class":244},[238,285,261],{"class":244},[238,287,264],{"class":244},[238,289,290],{"class":267},"INV-2026-00042",[238,292,258],{"class":244},[238,294,296],{"class":295},"sHwdD"," \u002F\u002F your reference; appears on statements and reporting\n",[238,298,300],{"class":240,"line":299},4,[238,301,302],{"class":244},"}\n",[163,304,306],{"id":305},"example-specific-card","Example (Specific card)",[147,308,309],{},"Charge one specific stored card only. The cascade is disabled — if this card declines, the charge fails.",[229,311,313],{"className":231,"code":312,"language":233,"meta":234,"style":234},"{\n  \"amount\": \"349.00\",\n  \"reference\": \"INV-2026-00042\",\n  \"card_id\": \"crd_SFq2E9LskQimPkf2mRqnV\" \u002F\u002F charge this card only; obtain card IDs from the card vault webhooks or the customer's card list\n}\n",[151,314,315,319,337,355,375],{"__ignoreMap":234},[238,316,317],{"class":240,"line":241},[238,318,245],{"class":244},[238,320,321,323,325,327,329,331,333,335],{"class":240,"line":248},[238,322,251],{"class":244},[238,324,255],{"class":254},[238,326,258],{"class":244},[238,328,261],{"class":244},[238,330,264],{"class":244},[238,332,268],{"class":267},[238,334,258],{"class":244},[238,336,273],{"class":244},[238,338,339,341,343,345,347,349,351,353],{"class":240,"line":276},[238,340,251],{"class":244},[238,342,281],{"class":254},[238,344,258],{"class":244},[238,346,261],{"class":244},[238,348,264],{"class":244},[238,350,290],{"class":267},[238,352,258],{"class":244},[238,354,273],{"class":244},[238,356,357,359,361,363,365,367,370,372],{"class":240,"line":299},[238,358,251],{"class":244},[238,360,153],{"class":254},[238,362,258],{"class":244},[238,364,261],{"class":244},[238,366,264],{"class":244},[238,368,369],{"class":267},"crd_SFq2E9LskQimPkf2mRqnV",[238,371,258],{"class":244},[238,373,374],{"class":295}," \u002F\u002F charge this card only; obtain card IDs from the card vault webhooks or the customer's card list\n",[238,376,378],{"class":240,"line":377},5,[238,379,302],{"class":244},[163,381,383],{"id":382},"example-advanced","Example (Advanced)",[147,385,386],{},"Advanced example with all options, including cascade controls, MIT classification, invoicing, and asynchronous processing.",[229,388,390],{"className":231,"code":389,"language":233,"meta":234,"style":234},"{\n  \"amount\": \"349.00\",\n  \"currency\": \"ZAR\", \u002F\u002F [optional] default \"ZAR\"\n\n  \"reference\": \"INV-2026-00042\", \u002F\u002F your reference; appears on statements and reporting\n  \"description\": \"July 2026 subscription\", \u002F\u002F [optional]\n\n  \"type\": \"UNSCHEDULED\", \u002F\u002F [optional] MIT classification: \"UNSCHEDULED\" (default) or \"RECURRING\" for fixed-schedule billing\n\n  \"signature\": \"secret-key-for-payload\", \u002F\u002F [optional] shared-secret signature for the payload, see the signature section below\n\n  \u002F\u002F Cascade behaviour — ignored when card_id is passed\n  \"cascade\": {\n    \"is_enabled\": true, \u002F\u002F [optional] default true — when false, only the default card is attempted\n    \"max_attempts\": 3, \u002F\u002F [optional] cap on the number of cards tried; defaults to all ACTIVE cards\n    \"card_order\": [ \u002F\u002F [optional] explicit order override; defaults to: default card first, then by priority\n      \"crd_SFq2E9LskQimPkf2mRqnV\",\n      \"crd_9kLmXw3RtYqPz8vNcE2aB\"\n    ],\n    \"skip_codes\": [\"DO_NOT_HONOUR\"] \u002F\u002F [optional] additional decline codes that abort the cascade; hard declines (e.g. SUSPECTED_FRAUD, STOLEN_CARD, PICKUP_CARD) always abort and cannot be overridden\n  },\n\n  \"settings\": {\n    \"is_async\": false \u002F\u002F [optional] default false — when true, the request returns charge_status PROCESSING immediately and the outcome is delivered via webhook\n  },\n\n  \u002F\u002F Issue and optionally email an invoice for this charge\n  \"invoice\": {\n    \"is_generate\": true,\n    \"is_send\": true \u002F\u002F send paid invoice to the customer when true\n  },\n\n  \"notification\": {\n    \"email\": \"me@my-email.co.za\", \u002F\u002F [optional] email notification on the charge outcome\n    \"webhook_url\": \"https:\u002F\u002Fmerchant.example\u002Fwebhooks\u002Fpayments\" \u002F\u002F webhook on charge.successful \u002F charge.failed\n  },\n\n  \"metadata\": {\n    \"order_id\": \"ord_98765\" \u002F\u002F [optional] custom key\u002Fvalue pairs returned on the charge and webhooks\n  }\n}\n",[151,391,392,396,414,438,444,464,488,493,517,522,546,551,557,572,592,613,631,643,654,660,687,693,698,712,730,735,740,746,760,775,793,798,803,817,841,863,868,873,887,909,915],{"__ignoreMap":234},[238,393,394],{"class":240,"line":241},[238,395,245],{"class":244},[238,397,398,400,402,404,406,408,410,412],{"class":240,"line":248},[238,399,251],{"class":244},[238,401,255],{"class":254},[238,403,258],{"class":244},[238,405,261],{"class":244},[238,407,264],{"class":244},[238,409,268],{"class":267},[238,411,258],{"class":244},[238,413,273],{"class":244},[238,415,416,418,421,423,425,427,430,432,435],{"class":240,"line":276},[238,417,251],{"class":244},[238,419,420],{"class":254},"currency",[238,422,258],{"class":244},[238,424,261],{"class":244},[238,426,264],{"class":244},[238,428,429],{"class":267},"ZAR",[238,431,258],{"class":244},[238,433,434],{"class":244},",",[238,436,437],{"class":295}," \u002F\u002F [optional] default \"ZAR\"\n",[238,439,440],{"class":240,"line":299},[238,441,443],{"emptyLinePlaceholder":442},true,"\n",[238,445,446,448,450,452,454,456,458,460,462],{"class":240,"line":377},[238,447,251],{"class":244},[238,449,281],{"class":254},[238,451,258],{"class":244},[238,453,261],{"class":244},[238,455,264],{"class":244},[238,457,290],{"class":267},[238,459,258],{"class":244},[238,461,434],{"class":244},[238,463,296],{"class":295},[238,465,467,469,472,474,476,478,481,483,485],{"class":240,"line":466},6,[238,468,251],{"class":244},[238,470,471],{"class":254},"description",[238,473,258],{"class":244},[238,475,261],{"class":244},[238,477,264],{"class":244},[238,479,480],{"class":267},"July 2026 subscription",[238,482,258],{"class":244},[238,484,434],{"class":244},[238,486,487],{"class":295}," \u002F\u002F [optional]\n",[238,489,491],{"class":240,"line":490},7,[238,492,443],{"emptyLinePlaceholder":442},[238,494,496,498,501,503,505,507,510,512,514],{"class":240,"line":495},8,[238,497,251],{"class":244},[238,499,500],{"class":254},"type",[238,502,258],{"class":244},[238,504,261],{"class":244},[238,506,264],{"class":244},[238,508,509],{"class":267},"UNSCHEDULED",[238,511,258],{"class":244},[238,513,434],{"class":244},[238,515,516],{"class":295}," \u002F\u002F [optional] MIT classification: \"UNSCHEDULED\" (default) or \"RECURRING\" for fixed-schedule billing\n",[238,518,520],{"class":240,"line":519},9,[238,521,443],{"emptyLinePlaceholder":442},[238,523,525,527,530,532,534,536,539,541,543],{"class":240,"line":524},10,[238,526,251],{"class":244},[238,528,529],{"class":254},"signature",[238,531,258],{"class":244},[238,533,261],{"class":244},[238,535,264],{"class":244},[238,537,538],{"class":267},"secret-key-for-payload",[238,540,258],{"class":244},[238,542,434],{"class":244},[238,544,545],{"class":295}," \u002F\u002F [optional] shared-secret signature for the payload, see the signature section below\n",[238,547,549],{"class":240,"line":548},11,[238,550,443],{"emptyLinePlaceholder":442},[238,552,554],{"class":240,"line":553},12,[238,555,556],{"class":295},"  \u002F\u002F Cascade behaviour — ignored when card_id is passed\n",[238,558,560,562,565,567,569],{"class":240,"line":559},13,[238,561,251],{"class":244},[238,563,564],{"class":254},"cascade",[238,566,258],{"class":244},[238,568,261],{"class":244},[238,570,571],{"class":244}," {\n",[238,573,575,578,582,584,586,589],{"class":240,"line":574},14,[238,576,577],{"class":244},"    \"",[238,579,581],{"class":580},"sBMFI","is_enabled",[238,583,258],{"class":244},[238,585,261],{"class":244},[238,587,588],{"class":244}," true,",[238,590,591],{"class":295}," \u002F\u002F [optional] default true — when false, only the default card is attempted\n",[238,593,595,597,600,602,604,608,610],{"class":240,"line":594},15,[238,596,577],{"class":244},[238,598,599],{"class":580},"max_attempts",[238,601,258],{"class":244},[238,603,261],{"class":244},[238,605,607],{"class":606},"sbssI"," 3",[238,609,434],{"class":244},[238,611,612],{"class":295}," \u002F\u002F [optional] cap on the number of cards tried; defaults to all ACTIVE cards\n",[238,614,616,618,621,623,625,628],{"class":240,"line":615},16,[238,617,577],{"class":244},[238,619,620],{"class":580},"card_order",[238,622,258],{"class":244},[238,624,261],{"class":244},[238,626,627],{"class":244}," [",[238,629,630],{"class":295}," \u002F\u002F [optional] explicit order override; defaults to: default card first, then by priority\n",[238,632,634,637,639,641],{"class":240,"line":633},17,[238,635,636],{"class":244},"      \"",[238,638,369],{"class":267},[238,640,258],{"class":244},[238,642,273],{"class":244},[238,644,646,648,651],{"class":240,"line":645},18,[238,647,636],{"class":244},[238,649,650],{"class":267},"crd_9kLmXw3RtYqPz8vNcE2aB",[238,652,653],{"class":244},"\"\n",[238,655,657],{"class":240,"line":656},19,[238,658,659],{"class":244},"    ],\n",[238,661,663,665,668,670,672,674,676,679,681,684],{"class":240,"line":662},20,[238,664,577],{"class":244},[238,666,667],{"class":580},"skip_codes",[238,669,258],{"class":244},[238,671,261],{"class":244},[238,673,627],{"class":244},[238,675,258],{"class":244},[238,677,678],{"class":267},"DO_NOT_HONOUR",[238,680,258],{"class":244},[238,682,683],{"class":244},"]",[238,685,686],{"class":295}," \u002F\u002F [optional] additional decline codes that abort the cascade; hard declines (e.g. SUSPECTED_FRAUD, STOLEN_CARD, PICKUP_CARD) always abort and cannot be overridden\n",[238,688,690],{"class":240,"line":689},21,[238,691,692],{"class":244},"  },\n",[238,694,696],{"class":240,"line":695},22,[238,697,443],{"emptyLinePlaceholder":442},[238,699,701,703,706,708,710],{"class":240,"line":700},23,[238,702,251],{"class":244},[238,704,705],{"class":254},"settings",[238,707,258],{"class":244},[238,709,261],{"class":244},[238,711,571],{"class":244},[238,713,715,717,720,722,724,727],{"class":240,"line":714},24,[238,716,577],{"class":244},[238,718,719],{"class":580},"is_async",[238,721,258],{"class":244},[238,723,261],{"class":244},[238,725,726],{"class":244}," false",[238,728,729],{"class":295}," \u002F\u002F [optional] default false — when true, the request returns charge_status PROCESSING immediately and the outcome is delivered via webhook\n",[238,731,733],{"class":240,"line":732},25,[238,734,692],{"class":244},[238,736,738],{"class":240,"line":737},26,[238,739,443],{"emptyLinePlaceholder":442},[238,741,743],{"class":240,"line":742},27,[238,744,745],{"class":295},"  \u002F\u002F Issue and optionally email an invoice for this charge\n",[238,747,749,751,754,756,758],{"class":240,"line":748},28,[238,750,251],{"class":244},[238,752,753],{"class":254},"invoice",[238,755,258],{"class":244},[238,757,261],{"class":244},[238,759,571],{"class":244},[238,761,763,765,768,770,772],{"class":240,"line":762},29,[238,764,577],{"class":244},[238,766,767],{"class":580},"is_generate",[238,769,258],{"class":244},[238,771,261],{"class":244},[238,773,774],{"class":244}," true,\n",[238,776,778,780,783,785,787,790],{"class":240,"line":777},30,[238,779,577],{"class":244},[238,781,782],{"class":580},"is_send",[238,784,258],{"class":244},[238,786,261],{"class":244},[238,788,789],{"class":244}," true",[238,791,792],{"class":295}," \u002F\u002F send paid invoice to the customer when true\n",[238,794,796],{"class":240,"line":795},31,[238,797,692],{"class":244},[238,799,801],{"class":240,"line":800},32,[238,802,443],{"emptyLinePlaceholder":442},[238,804,806,808,811,813,815],{"class":240,"line":805},33,[238,807,251],{"class":244},[238,809,810],{"class":254},"notification",[238,812,258],{"class":244},[238,814,261],{"class":244},[238,816,571],{"class":244},[238,818,820,822,825,827,829,831,834,836,838],{"class":240,"line":819},34,[238,821,577],{"class":244},[238,823,824],{"class":580},"email",[238,826,258],{"class":244},[238,828,261],{"class":244},[238,830,264],{"class":244},[238,832,833],{"class":267},"me@my-email.co.za",[238,835,258],{"class":244},[238,837,434],{"class":244},[238,839,840],{"class":295}," \u002F\u002F [optional] email notification on the charge outcome\n",[238,842,844,846,849,851,853,855,858,860],{"class":240,"line":843},35,[238,845,577],{"class":244},[238,847,848],{"class":580},"webhook_url",[238,850,258],{"class":244},[238,852,261],{"class":244},[238,854,264],{"class":244},[238,856,857],{"class":267},"https:\u002F\u002Fmerchant.example\u002Fwebhooks\u002Fpayments",[238,859,258],{"class":244},[238,861,862],{"class":295}," \u002F\u002F webhook on charge.successful \u002F charge.failed\n",[238,864,866],{"class":240,"line":865},36,[238,867,692],{"class":244},[238,869,871],{"class":240,"line":870},37,[238,872,443],{"emptyLinePlaceholder":442},[238,874,876,878,881,883,885],{"class":240,"line":875},38,[238,877,251],{"class":244},[238,879,880],{"class":254},"metadata",[238,882,258],{"class":244},[238,884,261],{"class":244},[238,886,571],{"class":244},[238,888,890,892,895,897,899,901,904,906],{"class":240,"line":889},39,[238,891,577],{"class":244},[238,893,894],{"class":580},"order_id",[238,896,258],{"class":244},[238,898,261],{"class":244},[238,900,264],{"class":244},[238,902,903],{"class":267},"ord_98765",[238,905,258],{"class":244},[238,907,908],{"class":295}," \u002F\u002F [optional] custom key\u002Fvalue pairs returned on the charge and webhooks\n",[238,910,912],{"class":240,"line":911},40,[238,913,914],{"class":244},"  }\n",[238,916,918],{"class":240,"line":917},41,[238,919,302],{"class":244},[163,921,923],{"id":922},"request-parameters","Request Parameters",[147,925,926,927,931,932,936,937,940],{},"Fields below appear in the ",[159,928,930],{"href":929},"#example-basic","request body examples"," on this page. ",[933,934,935],"strong",{},"Y"," = required for all requests, ",[933,938,939],{},"C"," = required or applicable depending on usage.",[177,942,943,966],{},[180,944,945],{},[183,946,947,954,957,959,964],{},[186,948,949],{"align":188},[950,951,953],"div",{"style":952},"width:100px","Field",[186,955,956],{"align":188},"Required",[186,958,192],{"align":188},[186,960,961],{"align":188},[950,962,195],{"style":963},"width:300px",[186,965,198],{"align":188},[200,967,968,982,1008,1022,1035,1048,1071,1089,1111,1131,1147,1179,1208,1221,1235,1249,1266,1283],{},[183,969,970,972,974,977,980],{},[205,971,255],{"align":188},[205,973,935],{"align":188},[205,975,976],{"align":188},"String",[205,978,979],{"align":188},"Amount to charge",[205,981,268],{"align":188},[183,983,984,986,989,992,1004],{},[205,985,420],{"align":188},[205,987,988],{"align":188},"N",[205,990,991],{"align":188},"String(3)",[205,993,994,1001,1002],{"align":188},[159,995,1000],{"href":996,"rel":997,":target":999},"https:\u002F\u002Fen.wikipedia.org\u002Fwiki\u002FISO_4217",[998],"nofollow","_blank","ISO 4217"," currency code. Default ",[151,1003,429],{},[205,1005,1006],{"align":188},[151,1007,429],{},[183,1009,1010,1012,1014,1017,1020],{},[205,1011,281],{"align":188},[205,1013,935],{"align":188},[205,1015,1016],{"align":188},"String(35)",[205,1018,1019],{"align":188},"Your reference for this charge; appears on statements and reporting. Must be unique per charge to support idempotent retries",[205,1021,290],{"align":188},[183,1023,1024,1026,1028,1030,1033],{},[205,1025,471],{"align":188},[205,1027,988],{"align":188},[205,1029,976],{"align":188},[205,1031,1032],{"align":188},"Optional longer description",[205,1034,480],{"align":188},[183,1036,1037,1039,1041,1043,1046],{},[205,1038,153],{"align":188},[205,1040,939],{"align":188},[205,1042,210],{"align":188},[205,1044,1045],{"align":188},"Charge this specific card only; the cascade is disabled. Omit to charge the customer with cascade",[205,1047,369],{"align":188},[183,1049,1050,1052,1054,1057,1067],{},[205,1051,500],{"align":188},[205,1053,988],{"align":188},[205,1055,1056],{"align":188},"ENUM",[205,1058,1059,1060,1062,1063,1066],{"align":188},"MIT classification for scheme compliance: ",[151,1061,509],{}," (default; ad-hoc merchant-initiated) or ",[151,1064,1065],{},"RECURRING"," (fixed-schedule billing)",[205,1068,1069],{"align":188},[151,1070,509],{},[183,1072,1073,1075,1077,1080,1086],{},[205,1074,564],{"align":188},[205,1076,988],{"align":188},[205,1078,1079],{"align":188},"Object",[205,1081,1082,1083,1085],{"align":188},"Cascade behaviour; ignored when ",[151,1084,153],{}," is passed",[205,1087,1088],{"align":188},"See advanced example",[183,1090,1091,1094,1096,1099,1109],{},[205,1092,1093],{"align":188},"cascade.is_enabled",[205,1095,988],{"align":188},[205,1097,1098],{"align":188},"Boolean",[205,1100,1101,1102,1105,1106],{"align":188},"When ",[151,1103,1104],{},"false",", only the default card is attempted. Default ",[151,1107,1108],{},"true",[205,1110,1108],{"align":188},[183,1112,1113,1116,1118,1121,1128],{},[205,1114,1115],{"align":188},"cascade.max_attempts",[205,1117,988],{"align":188},[205,1119,1120],{"align":188},"Integer",[205,1122,1123,1124,1127],{"align":188},"Cap on the number of cards tried; defaults to all ",[151,1125,1126],{},"ACTIVE"," cards",[205,1129,1130],{"align":188},"3",[183,1132,1133,1136,1138,1141,1144],{},[205,1134,1135],{"align":188},"cascade.card_order",[205,1137,988],{"align":188},[205,1139,1140],{"align":188},"Array",[205,1142,1143],{"align":188},"Explicit card order override; defaults to the default card first, then by priority",[205,1145,1146],{"align":188},"[crd_SFq2..., crd_9kLm...]",[183,1148,1149,1152,1154,1156,1174],{},[205,1150,1151],{"align":188},"cascade.skip_codes",[205,1153,988],{"align":188},[205,1155,1140],{"align":188},[205,1157,1158,1159,1162,1163,1162,1166,1169,1170],{"align":188},"Additional decline codes that abort the cascade instead of trying the next card. Hard declines (",[151,1160,1161],{},"SUSPECTED_FRAUD",", ",[151,1164,1165],{},"STOLEN_CARD",[151,1167,1168],{},"PICKUP_CARD",") always abort and cannot be overridden — see ",[159,1171,1173],{"href":1172},"\u002Freference\u002Flookups","lookups",[205,1175,1176,1177,683],{"align":188},"[",[151,1178,678],{},[183,1180,1181,1184,1186,1188,1206],{},[205,1182,1183],{"align":188},"settings.is_async",[205,1185,988],{"align":188},[205,1187,1098],{"align":188},[205,1189,1101,1190,1192,1193,172,1196,1199,1200,1203,1204],{"align":188},[151,1191,1108],{},", the request returns ",[151,1194,1195],{},"charge_status",[151,1197,1198],{},"PROCESSING"," immediately and the outcome is delivered via webhook; poll ",[151,1201,1202],{},"GET \u002Fcard-vault\u002F{customer_id}\u002Fcharges\u002F{charge_id}"," for status. Default ",[151,1205,1104],{},[205,1207,1104],{"align":188},[183,1209,1210,1212,1214,1216,1219],{},[205,1211,529],{"align":188},[205,1213,988],{"align":188},[205,1215,976],{"align":188},[205,1217,1218],{"align":188},"Optional passphrase signature for verifying the payload",[205,1220,538],{"align":188},[183,1222,1223,1226,1228,1230,1233],{},[205,1224,1225],{"align":188},"invoice.is_generate",[205,1227,988],{"align":188},[205,1229,1098],{"align":188},[205,1231,1232],{"align":188},"Whether to generate an invoice for the charge",[205,1234,1108],{"align":188},[183,1236,1237,1240,1242,1244,1247],{},[205,1238,1239],{"align":188},"invoice.is_send",[205,1241,988],{"align":188},[205,1243,1098],{"align":188},[205,1245,1246],{"align":188},"Whether to send the paid invoice to the customer",[205,1248,1108],{"align":188},[183,1250,1251,1254,1256,1258,1261],{},[205,1252,1253],{"align":188},"notification.email",[205,1255,988],{"align":188},[205,1257,976],{"align":188},[205,1259,1260],{"align":188},"Email address to notify on the charge outcome",[205,1262,1263],{"align":188},[159,1264,833],{"href":1265},"mailto:me@my-email.co.za",[183,1267,1268,1271,1273,1275,1278],{},[205,1269,1270],{"align":188},"notification.webhook_url",[205,1272,988],{"align":188},[205,1274,976],{"align":188},[205,1276,1277],{"align":188},"Webhook URL for the charge outcome",[205,1279,1280],{"align":188},[159,1281,857],{"href":857,"rel":1282},[998],[183,1284,1285,1287,1289,1291,1294],{},[205,1286,880],{"align":188},[205,1288,988],{"align":188},[205,1290,1079],{"align":188},[205,1292,1293],{"align":188},"Custom key\u002Fvalue metadata returned on the charge and webhooks",[205,1295,1296],{"align":188},[151,1297,1298],{},"{\"order_id\": \"ord_98765\"}",[163,1300,1302],{"id":1301},"response-body","Response Body",[147,1304,1305,1306,1309,1310,1313,1314,1317],{},"A charge (",[151,1307,1308],{},"chg_",") wraps one or more card transactions (",[151,1311,1312],{},"tra_","). Every attempt — including declines — is a real transaction with its own identifier, listed in ",[151,1315,1316],{},"attempts"," in the order they were tried.",[147,1319,1320],{},"Example where the default card declined and the second card succeeded:",[229,1322,1324],{"className":231,"code":1323,"language":233,"meta":234,"style":234},"{\n    \"status\": true,\n    \"result\": {\n      \"id\": \"chg_Wt5RmK2xPqLv9nYcE7aBz\",\n      \"customer_id\": \"cus_abc123...\",\n      \"amount\": \"349.00\",\n      \"currency\": \"ZAR\",\n      \"reference\": \"INV-2026-00042\",\n      \"charge_status\": \"SUCCESSFUL\",\n      \"card_id\": \"crd_9kLmXw3RtYqPz8vNcE2aB\",\n      \"transaction_id\": \"tra_pr6CvR_4pvWwmgQ4y3dtY\",\n      \"attempts\": [\n        {\n          \"sequence\": 1,\n          \"card_id\": \"crd_SFq2E9LskQimPkf2mRqnV\",\n          \"is_default\": true,\n          \"transaction_id\": \"tra_x9YtRw2QpLmN8vKcE3aBz\",\n          \"transaction_status\": \"DECLINED\",\n          \"error\": {\n            \"code\": \"INSUFFICIENT_FUNDS\",\n            \"message\": \"The transaction was declined due to insufficient funds\"\n          }\n        },\n        {\n          \"sequence\": 2,\n          \"card_id\": \"crd_9kLmXw3RtYqPz8vNcE2aB\",\n          \"is_default\": false,\n          \"transaction_id\": \"tra_pr6CvR_4pvWwmgQ4y3dtY\",\n          \"transaction_status\": \"SUCCESSFUL\"\n        }\n      ],\n      \"invoice_id\": \"inv_k2Jd8sLqPz...\",\n      \"created_at\": \"2026-07-06T10:15:30Z\"\n    }\n}\n",[151,1325,1326,1330,1343,1356,1376,1394,1412,1430,1448,1467,1485,1505,1518,1523,1540,1558,1571,1590,1610,1623,1644,1662,1667,1672,1676,1691,1709,1722,1740,1756,1761,1766,1786,1804,1809],{"__ignoreMap":234},[238,1327,1328],{"class":240,"line":241},[238,1329,245],{"class":244},[238,1331,1332,1334,1337,1339,1341],{"class":240,"line":248},[238,1333,577],{"class":244},[238,1335,1336],{"class":254},"status",[238,1338,258],{"class":244},[238,1340,261],{"class":244},[238,1342,774],{"class":244},[238,1344,1345,1347,1350,1352,1354],{"class":240,"line":276},[238,1346,577],{"class":244},[238,1348,1349],{"class":254},"result",[238,1351,258],{"class":244},[238,1353,261],{"class":244},[238,1355,571],{"class":244},[238,1357,1358,1360,1363,1365,1367,1369,1372,1374],{"class":240,"line":299},[238,1359,636],{"class":244},[238,1361,1362],{"class":580},"id",[238,1364,258],{"class":244},[238,1366,261],{"class":244},[238,1368,264],{"class":244},[238,1370,1371],{"class":267},"chg_Wt5RmK2xPqLv9nYcE7aBz",[238,1373,258],{"class":244},[238,1375,273],{"class":244},[238,1377,1378,1380,1382,1384,1386,1388,1390,1392],{"class":240,"line":377},[238,1379,636],{"class":244},[238,1381,207],{"class":580},[238,1383,258],{"class":244},[238,1385,261],{"class":244},[238,1387,264],{"class":244},[238,1389,220],{"class":267},[238,1391,258],{"class":244},[238,1393,273],{"class":244},[238,1395,1396,1398,1400,1402,1404,1406,1408,1410],{"class":240,"line":466},[238,1397,636],{"class":244},[238,1399,255],{"class":580},[238,1401,258],{"class":244},[238,1403,261],{"class":244},[238,1405,264],{"class":244},[238,1407,268],{"class":267},[238,1409,258],{"class":244},[238,1411,273],{"class":244},[238,1413,1414,1416,1418,1420,1422,1424,1426,1428],{"class":240,"line":490},[238,1415,636],{"class":244},[238,1417,420],{"class":580},[238,1419,258],{"class":244},[238,1421,261],{"class":244},[238,1423,264],{"class":244},[238,1425,429],{"class":267},[238,1427,258],{"class":244},[238,1429,273],{"class":244},[238,1431,1432,1434,1436,1438,1440,1442,1444,1446],{"class":240,"line":495},[238,1433,636],{"class":244},[238,1435,281],{"class":580},[238,1437,258],{"class":244},[238,1439,261],{"class":244},[238,1441,264],{"class":244},[238,1443,290],{"class":267},[238,1445,258],{"class":244},[238,1447,273],{"class":244},[238,1449,1450,1452,1454,1456,1458,1460,1463,1465],{"class":240,"line":519},[238,1451,636],{"class":244},[238,1453,1195],{"class":580},[238,1455,258],{"class":244},[238,1457,261],{"class":244},[238,1459,264],{"class":244},[238,1461,1462],{"class":267},"SUCCESSFUL",[238,1464,258],{"class":244},[238,1466,273],{"class":244},[238,1468,1469,1471,1473,1475,1477,1479,1481,1483],{"class":240,"line":524},[238,1470,636],{"class":244},[238,1472,153],{"class":580},[238,1474,258],{"class":244},[238,1476,261],{"class":244},[238,1478,264],{"class":244},[238,1480,650],{"class":267},[238,1482,258],{"class":244},[238,1484,273],{"class":244},[238,1486,1487,1489,1492,1494,1496,1498,1501,1503],{"class":240,"line":548},[238,1488,636],{"class":244},[238,1490,1491],{"class":580},"transaction_id",[238,1493,258],{"class":244},[238,1495,261],{"class":244},[238,1497,264],{"class":244},[238,1499,1500],{"class":267},"tra_pr6CvR_4pvWwmgQ4y3dtY",[238,1502,258],{"class":244},[238,1504,273],{"class":244},[238,1506,1507,1509,1511,1513,1515],{"class":240,"line":553},[238,1508,636],{"class":244},[238,1510,1316],{"class":580},[238,1512,258],{"class":244},[238,1514,261],{"class":244},[238,1516,1517],{"class":244}," [\n",[238,1519,1520],{"class":240,"line":559},[238,1521,1522],{"class":244},"        {\n",[238,1524,1525,1528,1531,1533,1535,1538],{"class":240,"line":574},[238,1526,1527],{"class":244},"          \"",[238,1529,1530],{"class":606},"sequence",[238,1532,258],{"class":244},[238,1534,261],{"class":244},[238,1536,1537],{"class":606}," 1",[238,1539,273],{"class":244},[238,1541,1542,1544,1546,1548,1550,1552,1554,1556],{"class":240,"line":594},[238,1543,1527],{"class":244},[238,1545,153],{"class":606},[238,1547,258],{"class":244},[238,1549,261],{"class":244},[238,1551,264],{"class":244},[238,1553,369],{"class":267},[238,1555,258],{"class":244},[238,1557,273],{"class":244},[238,1559,1560,1562,1565,1567,1569],{"class":240,"line":615},[238,1561,1527],{"class":244},[238,1563,1564],{"class":606},"is_default",[238,1566,258],{"class":244},[238,1568,261],{"class":244},[238,1570,774],{"class":244},[238,1572,1573,1575,1577,1579,1581,1583,1586,1588],{"class":240,"line":633},[238,1574,1527],{"class":244},[238,1576,1491],{"class":606},[238,1578,258],{"class":244},[238,1580,261],{"class":244},[238,1582,264],{"class":244},[238,1584,1585],{"class":267},"tra_x9YtRw2QpLmN8vKcE3aBz",[238,1587,258],{"class":244},[238,1589,273],{"class":244},[238,1591,1592,1594,1597,1599,1601,1603,1606,1608],{"class":240,"line":645},[238,1593,1527],{"class":244},[238,1595,1596],{"class":606},"transaction_status",[238,1598,258],{"class":244},[238,1600,261],{"class":244},[238,1602,264],{"class":244},[238,1604,1605],{"class":267},"DECLINED",[238,1607,258],{"class":244},[238,1609,273],{"class":244},[238,1611,1612,1614,1617,1619,1621],{"class":240,"line":656},[238,1613,1527],{"class":244},[238,1615,1616],{"class":606},"error",[238,1618,258],{"class":244},[238,1620,261],{"class":244},[238,1622,571],{"class":244},[238,1624,1625,1628,1631,1633,1635,1637,1640,1642],{"class":240,"line":662},[238,1626,1627],{"class":244},"            \"",[238,1629,151],{"class":1630},"swJcz",[238,1632,258],{"class":244},[238,1634,261],{"class":244},[238,1636,264],{"class":244},[238,1638,1639],{"class":267},"INSUFFICIENT_FUNDS",[238,1641,258],{"class":244},[238,1643,273],{"class":244},[238,1645,1646,1648,1651,1653,1655,1657,1660],{"class":240,"line":689},[238,1647,1627],{"class":244},[238,1649,1650],{"class":1630},"message",[238,1652,258],{"class":244},[238,1654,261],{"class":244},[238,1656,264],{"class":244},[238,1658,1659],{"class":267},"The transaction was declined due to insufficient funds",[238,1661,653],{"class":244},[238,1663,1664],{"class":240,"line":695},[238,1665,1666],{"class":244},"          }\n",[238,1668,1669],{"class":240,"line":700},[238,1670,1671],{"class":244},"        },\n",[238,1673,1674],{"class":240,"line":714},[238,1675,1522],{"class":244},[238,1677,1678,1680,1682,1684,1686,1689],{"class":240,"line":732},[238,1679,1527],{"class":244},[238,1681,1530],{"class":606},[238,1683,258],{"class":244},[238,1685,261],{"class":244},[238,1687,1688],{"class":606}," 2",[238,1690,273],{"class":244},[238,1692,1693,1695,1697,1699,1701,1703,1705,1707],{"class":240,"line":737},[238,1694,1527],{"class":244},[238,1696,153],{"class":606},[238,1698,258],{"class":244},[238,1700,261],{"class":244},[238,1702,264],{"class":244},[238,1704,650],{"class":267},[238,1706,258],{"class":244},[238,1708,273],{"class":244},[238,1710,1711,1713,1715,1717,1719],{"class":240,"line":742},[238,1712,1527],{"class":244},[238,1714,1564],{"class":606},[238,1716,258],{"class":244},[238,1718,261],{"class":244},[238,1720,1721],{"class":244}," false,\n",[238,1723,1724,1726,1728,1730,1732,1734,1736,1738],{"class":240,"line":748},[238,1725,1527],{"class":244},[238,1727,1491],{"class":606},[238,1729,258],{"class":244},[238,1731,261],{"class":244},[238,1733,264],{"class":244},[238,1735,1500],{"class":267},[238,1737,258],{"class":244},[238,1739,273],{"class":244},[238,1741,1742,1744,1746,1748,1750,1752,1754],{"class":240,"line":762},[238,1743,1527],{"class":244},[238,1745,1596],{"class":606},[238,1747,258],{"class":244},[238,1749,261],{"class":244},[238,1751,264],{"class":244},[238,1753,1462],{"class":267},[238,1755,653],{"class":244},[238,1757,1758],{"class":240,"line":777},[238,1759,1760],{"class":244},"        }\n",[238,1762,1763],{"class":240,"line":795},[238,1764,1765],{"class":244},"      ],\n",[238,1767,1768,1770,1773,1775,1777,1779,1782,1784],{"class":240,"line":800},[238,1769,636],{"class":244},[238,1771,1772],{"class":580},"invoice_id",[238,1774,258],{"class":244},[238,1776,261],{"class":244},[238,1778,264],{"class":244},[238,1780,1781],{"class":267},"inv_k2Jd8sLqPz...",[238,1783,258],{"class":244},[238,1785,273],{"class":244},[238,1787,1788,1790,1793,1795,1797,1799,1802],{"class":240,"line":805},[238,1789,636],{"class":244},[238,1791,1792],{"class":580},"created_at",[238,1794,258],{"class":244},[238,1796,261],{"class":244},[238,1798,264],{"class":244},[238,1800,1801],{"class":267},"2026-07-06T10:15:30Z",[238,1803,653],{"class":244},[238,1805,1806],{"class":240,"line":819},[238,1807,1808],{"class":244},"    }\n",[238,1810,1811],{"class":240,"line":843},[238,1812,302],{"class":244},[147,1814,1815],{},"Example where all cards declined:",[229,1817,1819],{"className":231,"code":1818,"language":233,"meta":234,"style":234},"{\n    \"status\": false,\n    \"result\": {\n      \"id\": \"chg_Rk8NwT4yQmXz2pLvE9aBc\",\n      \"customer_id\": \"cus_abc123...\",\n      \"amount\": \"349.00\",\n      \"currency\": \"ZAR\",\n      \"reference\": \"INV-2026-00042\",\n      \"charge_status\": \"FAILED\",\n      \"card_id\": null,\n      \"transaction_id\": null,\n      \"attempts\": [\n        {\n          \"sequence\": 1,\n          \"card_id\": \"crd_SFq2E9LskQimPkf2mRqnV\",\n          \"is_default\": true,\n          \"transaction_id\": \"tra_x9YtRw2QpLmN8vKcE3aBz\",\n          \"transaction_status\": \"DECLINED\",\n          \"error\": {\n            \"code\": \"INSUFFICIENT_FUNDS\",\n            \"message\": \"The transaction was declined due to insufficient funds\"\n          }\n        },\n        {\n          \"sequence\": 2,\n          \"card_id\": \"crd_9kLmXw3RtYqPz8vNcE2aB\",\n          \"is_default\": false,\n          \"transaction_id\": \"tra_z2QpLvE9aBcRk8NwT4yQm\",\n          \"transaction_status\": \"DECLINED\",\n          \"error\": {\n            \"code\": \"EXPIRED_CARD\",\n            \"message\": \"The transaction was declined because the card has expired\"\n          }\n        }\n      ],\n      \"created_at\": \"2026-07-06T10:15:35Z\"\n    }\n}\n",[151,1820,1821,1825,1837,1849,1868,1886,1904,1922,1940,1959,1972,1984,1996,2000,2014,2032,2044,2062,2080,2092,2110,2126,2130,2134,2138,2152,2170,2182,2201,2219,2231,2250,2267,2271,2275,2279,2296,2300],{"__ignoreMap":234},[238,1822,1823],{"class":240,"line":241},[238,1824,245],{"class":244},[238,1826,1827,1829,1831,1833,1835],{"class":240,"line":248},[238,1828,577],{"class":244},[238,1830,1336],{"class":254},[238,1832,258],{"class":244},[238,1834,261],{"class":244},[238,1836,1721],{"class":244},[238,1838,1839,1841,1843,1845,1847],{"class":240,"line":276},[238,1840,577],{"class":244},[238,1842,1349],{"class":254},[238,1844,258],{"class":244},[238,1846,261],{"class":244},[238,1848,571],{"class":244},[238,1850,1851,1853,1855,1857,1859,1861,1864,1866],{"class":240,"line":299},[238,1852,636],{"class":244},[238,1854,1362],{"class":580},[238,1856,258],{"class":244},[238,1858,261],{"class":244},[238,1860,264],{"class":244},[238,1862,1863],{"class":267},"chg_Rk8NwT4yQmXz2pLvE9aBc",[238,1865,258],{"class":244},[238,1867,273],{"class":244},[238,1869,1870,1872,1874,1876,1878,1880,1882,1884],{"class":240,"line":377},[238,1871,636],{"class":244},[238,1873,207],{"class":580},[238,1875,258],{"class":244},[238,1877,261],{"class":244},[238,1879,264],{"class":244},[238,1881,220],{"class":267},[238,1883,258],{"class":244},[238,1885,273],{"class":244},[238,1887,1888,1890,1892,1894,1896,1898,1900,1902],{"class":240,"line":466},[238,1889,636],{"class":244},[238,1891,255],{"class":580},[238,1893,258],{"class":244},[238,1895,261],{"class":244},[238,1897,264],{"class":244},[238,1899,268],{"class":267},[238,1901,258],{"class":244},[238,1903,273],{"class":244},[238,1905,1906,1908,1910,1912,1914,1916,1918,1920],{"class":240,"line":490},[238,1907,636],{"class":244},[238,1909,420],{"class":580},[238,1911,258],{"class":244},[238,1913,261],{"class":244},[238,1915,264],{"class":244},[238,1917,429],{"class":267},[238,1919,258],{"class":244},[238,1921,273],{"class":244},[238,1923,1924,1926,1928,1930,1932,1934,1936,1938],{"class":240,"line":495},[238,1925,636],{"class":244},[238,1927,281],{"class":580},[238,1929,258],{"class":244},[238,1931,261],{"class":244},[238,1933,264],{"class":244},[238,1935,290],{"class":267},[238,1937,258],{"class":244},[238,1939,273],{"class":244},[238,1941,1942,1944,1946,1948,1950,1952,1955,1957],{"class":240,"line":519},[238,1943,636],{"class":244},[238,1945,1195],{"class":580},[238,1947,258],{"class":244},[238,1949,261],{"class":244},[238,1951,264],{"class":244},[238,1953,1954],{"class":267},"FAILED",[238,1956,258],{"class":244},[238,1958,273],{"class":244},[238,1960,1961,1963,1965,1967,1969],{"class":240,"line":524},[238,1962,636],{"class":244},[238,1964,153],{"class":580},[238,1966,258],{"class":244},[238,1968,261],{"class":244},[238,1970,1971],{"class":244}," null,\n",[238,1973,1974,1976,1978,1980,1982],{"class":240,"line":548},[238,1975,636],{"class":244},[238,1977,1491],{"class":580},[238,1979,258],{"class":244},[238,1981,261],{"class":244},[238,1983,1971],{"class":244},[238,1985,1986,1988,1990,1992,1994],{"class":240,"line":553},[238,1987,636],{"class":244},[238,1989,1316],{"class":580},[238,1991,258],{"class":244},[238,1993,261],{"class":244},[238,1995,1517],{"class":244},[238,1997,1998],{"class":240,"line":559},[238,1999,1522],{"class":244},[238,2001,2002,2004,2006,2008,2010,2012],{"class":240,"line":574},[238,2003,1527],{"class":244},[238,2005,1530],{"class":606},[238,2007,258],{"class":244},[238,2009,261],{"class":244},[238,2011,1537],{"class":606},[238,2013,273],{"class":244},[238,2015,2016,2018,2020,2022,2024,2026,2028,2030],{"class":240,"line":594},[238,2017,1527],{"class":244},[238,2019,153],{"class":606},[238,2021,258],{"class":244},[238,2023,261],{"class":244},[238,2025,264],{"class":244},[238,2027,369],{"class":267},[238,2029,258],{"class":244},[238,2031,273],{"class":244},[238,2033,2034,2036,2038,2040,2042],{"class":240,"line":615},[238,2035,1527],{"class":244},[238,2037,1564],{"class":606},[238,2039,258],{"class":244},[238,2041,261],{"class":244},[238,2043,774],{"class":244},[238,2045,2046,2048,2050,2052,2054,2056,2058,2060],{"class":240,"line":633},[238,2047,1527],{"class":244},[238,2049,1491],{"class":606},[238,2051,258],{"class":244},[238,2053,261],{"class":244},[238,2055,264],{"class":244},[238,2057,1585],{"class":267},[238,2059,258],{"class":244},[238,2061,273],{"class":244},[238,2063,2064,2066,2068,2070,2072,2074,2076,2078],{"class":240,"line":645},[238,2065,1527],{"class":244},[238,2067,1596],{"class":606},[238,2069,258],{"class":244},[238,2071,261],{"class":244},[238,2073,264],{"class":244},[238,2075,1605],{"class":267},[238,2077,258],{"class":244},[238,2079,273],{"class":244},[238,2081,2082,2084,2086,2088,2090],{"class":240,"line":656},[238,2083,1527],{"class":244},[238,2085,1616],{"class":606},[238,2087,258],{"class":244},[238,2089,261],{"class":244},[238,2091,571],{"class":244},[238,2093,2094,2096,2098,2100,2102,2104,2106,2108],{"class":240,"line":662},[238,2095,1627],{"class":244},[238,2097,151],{"class":1630},[238,2099,258],{"class":244},[238,2101,261],{"class":244},[238,2103,264],{"class":244},[238,2105,1639],{"class":267},[238,2107,258],{"class":244},[238,2109,273],{"class":244},[238,2111,2112,2114,2116,2118,2120,2122,2124],{"class":240,"line":689},[238,2113,1627],{"class":244},[238,2115,1650],{"class":1630},[238,2117,258],{"class":244},[238,2119,261],{"class":244},[238,2121,264],{"class":244},[238,2123,1659],{"class":267},[238,2125,653],{"class":244},[238,2127,2128],{"class":240,"line":695},[238,2129,1666],{"class":244},[238,2131,2132],{"class":240,"line":700},[238,2133,1671],{"class":244},[238,2135,2136],{"class":240,"line":714},[238,2137,1522],{"class":244},[238,2139,2140,2142,2144,2146,2148,2150],{"class":240,"line":732},[238,2141,1527],{"class":244},[238,2143,1530],{"class":606},[238,2145,258],{"class":244},[238,2147,261],{"class":244},[238,2149,1688],{"class":606},[238,2151,273],{"class":244},[238,2153,2154,2156,2158,2160,2162,2164,2166,2168],{"class":240,"line":737},[238,2155,1527],{"class":244},[238,2157,153],{"class":606},[238,2159,258],{"class":244},[238,2161,261],{"class":244},[238,2163,264],{"class":244},[238,2165,650],{"class":267},[238,2167,258],{"class":244},[238,2169,273],{"class":244},[238,2171,2172,2174,2176,2178,2180],{"class":240,"line":742},[238,2173,1527],{"class":244},[238,2175,1564],{"class":606},[238,2177,258],{"class":244},[238,2179,261],{"class":244},[238,2181,1721],{"class":244},[238,2183,2184,2186,2188,2190,2192,2194,2197,2199],{"class":240,"line":748},[238,2185,1527],{"class":244},[238,2187,1491],{"class":606},[238,2189,258],{"class":244},[238,2191,261],{"class":244},[238,2193,264],{"class":244},[238,2195,2196],{"class":267},"tra_z2QpLvE9aBcRk8NwT4yQm",[238,2198,258],{"class":244},[238,2200,273],{"class":244},[238,2202,2203,2205,2207,2209,2211,2213,2215,2217],{"class":240,"line":762},[238,2204,1527],{"class":244},[238,2206,1596],{"class":606},[238,2208,258],{"class":244},[238,2210,261],{"class":244},[238,2212,264],{"class":244},[238,2214,1605],{"class":267},[238,2216,258],{"class":244},[238,2218,273],{"class":244},[238,2220,2221,2223,2225,2227,2229],{"class":240,"line":777},[238,2222,1527],{"class":244},[238,2224,1616],{"class":606},[238,2226,258],{"class":244},[238,2228,261],{"class":244},[238,2230,571],{"class":244},[238,2232,2233,2235,2237,2239,2241,2243,2246,2248],{"class":240,"line":795},[238,2234,1627],{"class":244},[238,2236,151],{"class":1630},[238,2238,258],{"class":244},[238,2240,261],{"class":244},[238,2242,264],{"class":244},[238,2244,2245],{"class":267},"EXPIRED_CARD",[238,2247,258],{"class":244},[238,2249,273],{"class":244},[238,2251,2252,2254,2256,2258,2260,2262,2265],{"class":240,"line":800},[238,2253,1627],{"class":244},[238,2255,1650],{"class":1630},[238,2257,258],{"class":244},[238,2259,261],{"class":244},[238,2261,264],{"class":244},[238,2263,2264],{"class":267},"The transaction was declined because the card has expired",[238,2266,653],{"class":244},[238,2268,2269],{"class":240,"line":805},[238,2270,1666],{"class":244},[238,2272,2273],{"class":240,"line":819},[238,2274,1760],{"class":244},[238,2276,2277],{"class":240,"line":843},[238,2278,1765],{"class":244},[238,2280,2281,2283,2285,2287,2289,2291,2294],{"class":240,"line":865},[238,2282,636],{"class":244},[238,2284,1792],{"class":580},[238,2286,258],{"class":244},[238,2288,261],{"class":244},[238,2290,264],{"class":244},[238,2292,2293],{"class":267},"2026-07-06T10:15:35Z",[238,2295,653],{"class":244},[238,2297,2298],{"class":240,"line":870},[238,2299,1808],{"class":244},[238,2301,2302],{"class":240,"line":875},[238,2303,302],{"class":244},[147,2305,1101,2306,2308,2309,2311,2312,172,2314,2316,2317,2319,2320,2324],{},[151,2307,1183],{}," is ",[151,2310,1108],{},", the response returns immediately with ",[151,2313,1195],{},[151,2315,1198],{}," and an empty ",[151,2318,1316],{}," array; the outcome is delivered via ",[159,2321,2323],{"href":2322},"#webhook","webhook",".",[163,2326,2328],{"id":2327},"response-parameters","Response Parameters",[177,2330,2331,2347],{},[180,2332,2333],{},[183,2334,2335,2339,2341,2345],{},[186,2336,2337],{"align":188},[950,2338,953],{"style":952},[186,2340,192],{"align":188},[186,2342,2343],{"align":188},[950,2344,195],{"style":963},[186,2346,198],{"align":188},[200,2348,2349,2360,2372,2384,2396,2413,2425,2449,2465,2479,2494,2509,2523,2537,2551,2569,2587,2601,2619],{},[183,2350,2351,2353,2355,2358],{},[205,2352,1336],{"align":188},[205,2354,1098],{"align":188},[205,2356,2357],{"align":188},"Whether the charge succeeded",[205,2359,1108],{"align":188},[183,2361,2362,2365,2367,2370],{},[205,2363,2364],{"align":188},"result.id",[205,2366,210],{"align":188},[205,2368,2369],{"align":188},"Unique charge identifier wrapping all cascade attempts",[205,2371,1371],{"align":188},[183,2373,2374,2377,2379,2382],{},[205,2375,2376],{"align":188},"result.customer_id",[205,2378,210],{"align":188},[205,2380,2381],{"align":188},"Associated customer ID",[205,2383,220],{"align":188},[183,2385,2386,2389,2391,2394],{},[205,2387,2388],{"align":188},"result.amount",[205,2390,976],{"align":188},[205,2392,2393],{"align":188},"Charge amount",[205,2395,268],{"align":188},[183,2397,2398,2401,2403,2409],{},[205,2399,2400],{"align":188},"result.currency",[205,2402,991],{"align":188},[205,2404,2405,2408],{"align":188},[159,2406,1000],{"href":996,"rel":2407,":target":999},[998]," currency code",[205,2410,2411],{"align":188},[151,2412,429],{},[183,2414,2415,2418,2420,2423],{},[205,2416,2417],{"align":188},"result.reference",[205,2419,1016],{"align":188},[205,2421,2422],{"align":188},"Your reference for this charge",[205,2424,290],{"align":188},[183,2426,2427,2430,2432,2445],{},[205,2428,2429],{"align":188},"result.charge_status",[205,2431,1056],{"align":188},[205,2433,2434,2435,1162,2437,2439,2440,2442,2443],{"align":188},"Overall charge outcome: ",[151,2436,1462],{},[151,2438,1954],{},", or ",[151,2441,1198],{}," (async), see ",[159,2444,1173],{"href":1172},[205,2446,2447],{"align":188},[151,2448,1462],{},[183,2450,2451,2454,2456,2463],{},[205,2452,2453],{"align":188},"result.card_id",[205,2455,210],{"align":188},[205,2457,2458,2459,2462],{"align":188},"The card that ultimately succeeded; ",[151,2460,2461],{},"null"," when the charge failed",[205,2464,650],{"align":188},[183,2466,2467,2470,2472,2477],{},[205,2468,2469],{"align":188},"result.transaction_id",[205,2471,210],{"align":188},[205,2473,2474,2475,2462],{"align":188},"The successful transaction; ",[151,2476,2461],{},[205,2478,1500],{"align":188},[183,2480,2481,2484,2486,2489],{},[205,2482,2483],{"align":188},"result.attempts",[205,2485,1140],{"align":188},[205,2487,2488],{"align":188},"Every card attempt in the order tried, including declines",[205,2490,2491],{"align":188},[238,2492,2493],{},"...",[183,2495,2496,2501,2503,2506],{},[205,2497,2483,2498,2500],{"align":188},[238,2499],{},".sequence",[205,2502,1120],{"align":188},[205,2504,2505],{"align":188},"Position of this attempt in the cascade",[205,2507,2508],{"align":188},"1",[183,2510,2511,2516,2518,2521],{},[205,2512,2483,2513,2515],{"align":188},[238,2514],{},".card_id",[205,2517,210],{"align":188},[205,2519,2520],{"align":188},"Card attempted",[205,2522,369],{"align":188},[183,2524,2525,2530,2532,2535],{},[205,2526,2483,2527,2529],{"align":188},[238,2528],{},".is_default",[205,2531,1098],{"align":188},[205,2533,2534],{"align":188},"Whether this card was the customer's default at the time of the charge",[205,2536,1108],{"align":188},[183,2538,2539,2544,2546,2549],{},[205,2540,2483,2541,2543],{"align":188},[238,2542],{},".transaction_id",[205,2545,210],{"align":188},[205,2547,2548],{"align":188},"Transaction identifier for this attempt",[205,2550,1585],{"align":188},[183,2552,2553,2558,2560,2565],{},[205,2554,2483,2555,2557],{"align":188},[238,2556],{},".transaction_status",[205,2559,1056],{"align":188},[205,2561,2562,2563],{"align":188},"Transaction status, see ",[159,2564,1173],{"href":1172},[205,2566,2567],{"align":188},[151,2568,1605],{},[183,2570,2571,2576,2578,2583],{},[205,2572,2483,2573,2575],{"align":188},[238,2574],{},".error.code",[205,2577,1056],{"align":188},[205,2579,2580,2581],{"align":188},"Decline code when the attempt failed, see ",[159,2582,1173],{"href":1172},[205,2584,2585],{"align":188},[151,2586,1639],{},[183,2588,2589,2594,2596,2599],{},[205,2590,2483,2591,2593],{"align":188},[238,2592],{},".error.message",[205,2595,976],{"align":188},[205,2597,2598],{"align":188},"Human-readable decline reason",[205,2600,1659],{"align":188},[183,2602,2603,2606,2608,2617],{},[205,2604,2605],{"align":188},"result.invoice_id",[205,2607,210],{"align":188},[205,2609,2610,2611,2613,2614,2616],{"align":188},"Invoice identifier; present when ",[151,2612,1225],{}," was ",[151,2615,1108],{}," and the charge succeeded",[205,2618,1781],{"align":188},[183,2620,2621,2624,2626,2629],{},[205,2622,2623],{"align":188},"result.created_at",[205,2625,976],{"align":188},[205,2627,2628],{"align":188},"ISO timestamp when the charge was created",[205,2630,1801],{"align":188},[142,2632,2634],{"id":2633},"signature-creation","Signature creation",[147,2636,2637,2638,2640,2641,2645],{},"When creating API keys on the dashboard you can download a passphrase key, use it to generate your signature and send it in the ",[151,2639,529],{}," parameter. The canonicalization and HMAC-SHA256 process is identical across all endpoints — see ",[159,2642,2644],{"href":2643},"\u002Fv2\u002Fmoney-in\u002Fcheckout-link#signature-creation","Checkout Link — Signature creation"," for Node.js, PHP, C#, Java, and Python examples.",[142,2647,2648],{"id":2323},"Webhook",[147,2650,2651,2652,2654],{},"When a charge completes or fails, a webhook may be delivered to ",[151,2653,1270],{}," when that field was supplied on create. Broader platform webhooks are configured separately if applicable. Webhooks fire once per charge outcome, not per cascade attempt.",[147,2656,2657,2658,2661,2662,2665,2666,2669,2670,2324],{},"Possible ",[151,2659,2660],{},"event"," values include ",[151,2663,2664],{},"charge.successful"," and ",[151,2667,2668],{},"charge.failed",", listed under ",[159,2671,2673],{"href":2672},"#webhook-events","Webhook events",[163,2675,2677],{"id":2676},"webhook-payload","Webhook Payload",[229,2679,2681],{"className":231,"code":2680,"language":233,"meta":234,"style":234},"{\n  \u002F\u002F charge.successful · charge.failed\n  \"event\": \"charge.successful\",\n  \"data\": [\n    {\n      \"charge\": {\n        \"id\": \"chg_Wt5RmK2xPqLv9nYcE7aBz\",\n        \"customer_id\": \"cus_abc123...\",\n        \"amount\": \"349.00\",\n        \"currency\": \"ZAR\",\n        \"reference\": \"INV-2026-00042\",\n        \"charge_status\": \"SUCCESSFUL\",\n        \"card_id\": \"crd_9kLmXw3RtYqPz8vNcE2aB\",\n        \"transaction_id\": \"tra_pr6CvR_4pvWwmgQ4y3dtY\",\n        \"attempts\": [\n          {\n            \"sequence\": 1,\n            \"card_id\": \"crd_SFq2E9LskQimPkf2mRqnV\",\n            \"is_default\": true,\n            \"transaction_id\": \"tra_x9YtRw2QpLmN8vKcE3aBz\",\n            \"transaction_status\": \"DECLINED\",\n            \"error\": {\n              \"code\": \"INSUFFICIENT_FUNDS\",\n              \"message\": \"The transaction was declined due to insufficient funds\"\n            }\n          },\n          {\n            \"sequence\": 2,\n            \"card_id\": \"crd_9kLmXw3RtYqPz8vNcE2aB\",\n            \"is_default\": false,\n            \"transaction_id\": \"tra_pr6CvR_4pvWwmgQ4y3dtY\",\n            \"transaction_status\": \"SUCCESSFUL\"\n          }\n        ],\n        \"invoice_id\": \"inv_k2Jd8sLqPz...\",\n        \"metadata\": {\n          \"order_id\": \"ord_98765\"\n        },\n        \"completed_at\": \"2026-07-06T10:15:30Z\"\n      }\n    }\n  ],\n  \"created_at\": \"2026-07-06T10:15:30Z\"\n}\n",[151,2682,2683,2687,2692,2710,2723,2728,2741,2760,2778,2796,2814,2832,2850,2868,2886,2898,2903,2917,2935,2947,2965,2983,2995,3015,3031,3036,3041,3045,3059,3077,3089,3107,3123,3127,3132,3150,3162,3178,3182,3199,3204,3208,3214,3231],{"__ignoreMap":234},[238,2684,2685],{"class":240,"line":241},[238,2686,245],{"class":244},[238,2688,2689],{"class":240,"line":248},[238,2690,2691],{"class":295},"  \u002F\u002F charge.successful · charge.failed\n",[238,2693,2694,2696,2698,2700,2702,2704,2706,2708],{"class":240,"line":276},[238,2695,251],{"class":244},[238,2697,2660],{"class":254},[238,2699,258],{"class":244},[238,2701,261],{"class":244},[238,2703,264],{"class":244},[238,2705,2664],{"class":267},[238,2707,258],{"class":244},[238,2709,273],{"class":244},[238,2711,2712,2714,2717,2719,2721],{"class":240,"line":299},[238,2713,251],{"class":244},[238,2715,2716],{"class":254},"data",[238,2718,258],{"class":244},[238,2720,261],{"class":244},[238,2722,1517],{"class":244},[238,2724,2725],{"class":240,"line":377},[238,2726,2727],{"class":244},"    {\n",[238,2729,2730,2732,2735,2737,2739],{"class":240,"line":466},[238,2731,636],{"class":244},[238,2733,2734],{"class":580},"charge",[238,2736,258],{"class":244},[238,2738,261],{"class":244},[238,2740,571],{"class":244},[238,2742,2743,2746,2748,2750,2752,2754,2756,2758],{"class":240,"line":490},[238,2744,2745],{"class":244},"        \"",[238,2747,1362],{"class":606},[238,2749,258],{"class":244},[238,2751,261],{"class":244},[238,2753,264],{"class":244},[238,2755,1371],{"class":267},[238,2757,258],{"class":244},[238,2759,273],{"class":244},[238,2761,2762,2764,2766,2768,2770,2772,2774,2776],{"class":240,"line":495},[238,2763,2745],{"class":244},[238,2765,207],{"class":606},[238,2767,258],{"class":244},[238,2769,261],{"class":244},[238,2771,264],{"class":244},[238,2773,220],{"class":267},[238,2775,258],{"class":244},[238,2777,273],{"class":244},[238,2779,2780,2782,2784,2786,2788,2790,2792,2794],{"class":240,"line":519},[238,2781,2745],{"class":244},[238,2783,255],{"class":606},[238,2785,258],{"class":244},[238,2787,261],{"class":244},[238,2789,264],{"class":244},[238,2791,268],{"class":267},[238,2793,258],{"class":244},[238,2795,273],{"class":244},[238,2797,2798,2800,2802,2804,2806,2808,2810,2812],{"class":240,"line":524},[238,2799,2745],{"class":244},[238,2801,420],{"class":606},[238,2803,258],{"class":244},[238,2805,261],{"class":244},[238,2807,264],{"class":244},[238,2809,429],{"class":267},[238,2811,258],{"class":244},[238,2813,273],{"class":244},[238,2815,2816,2818,2820,2822,2824,2826,2828,2830],{"class":240,"line":548},[238,2817,2745],{"class":244},[238,2819,281],{"class":606},[238,2821,258],{"class":244},[238,2823,261],{"class":244},[238,2825,264],{"class":244},[238,2827,290],{"class":267},[238,2829,258],{"class":244},[238,2831,273],{"class":244},[238,2833,2834,2836,2838,2840,2842,2844,2846,2848],{"class":240,"line":553},[238,2835,2745],{"class":244},[238,2837,1195],{"class":606},[238,2839,258],{"class":244},[238,2841,261],{"class":244},[238,2843,264],{"class":244},[238,2845,1462],{"class":267},[238,2847,258],{"class":244},[238,2849,273],{"class":244},[238,2851,2852,2854,2856,2858,2860,2862,2864,2866],{"class":240,"line":559},[238,2853,2745],{"class":244},[238,2855,153],{"class":606},[238,2857,258],{"class":244},[238,2859,261],{"class":244},[238,2861,264],{"class":244},[238,2863,650],{"class":267},[238,2865,258],{"class":244},[238,2867,273],{"class":244},[238,2869,2870,2872,2874,2876,2878,2880,2882,2884],{"class":240,"line":574},[238,2871,2745],{"class":244},[238,2873,1491],{"class":606},[238,2875,258],{"class":244},[238,2877,261],{"class":244},[238,2879,264],{"class":244},[238,2881,1500],{"class":267},[238,2883,258],{"class":244},[238,2885,273],{"class":244},[238,2887,2888,2890,2892,2894,2896],{"class":240,"line":594},[238,2889,2745],{"class":244},[238,2891,1316],{"class":606},[238,2893,258],{"class":244},[238,2895,261],{"class":244},[238,2897,1517],{"class":244},[238,2899,2900],{"class":240,"line":615},[238,2901,2902],{"class":244},"          {\n",[238,2904,2905,2907,2909,2911,2913,2915],{"class":240,"line":633},[238,2906,1627],{"class":244},[238,2908,1530],{"class":1630},[238,2910,258],{"class":244},[238,2912,261],{"class":244},[238,2914,1537],{"class":606},[238,2916,273],{"class":244},[238,2918,2919,2921,2923,2925,2927,2929,2931,2933],{"class":240,"line":645},[238,2920,1627],{"class":244},[238,2922,153],{"class":1630},[238,2924,258],{"class":244},[238,2926,261],{"class":244},[238,2928,264],{"class":244},[238,2930,369],{"class":267},[238,2932,258],{"class":244},[238,2934,273],{"class":244},[238,2936,2937,2939,2941,2943,2945],{"class":240,"line":656},[238,2938,1627],{"class":244},[238,2940,1564],{"class":1630},[238,2942,258],{"class":244},[238,2944,261],{"class":244},[238,2946,774],{"class":244},[238,2948,2949,2951,2953,2955,2957,2959,2961,2963],{"class":240,"line":662},[238,2950,1627],{"class":244},[238,2952,1491],{"class":1630},[238,2954,258],{"class":244},[238,2956,261],{"class":244},[238,2958,264],{"class":244},[238,2960,1585],{"class":267},[238,2962,258],{"class":244},[238,2964,273],{"class":244},[238,2966,2967,2969,2971,2973,2975,2977,2979,2981],{"class":240,"line":689},[238,2968,1627],{"class":244},[238,2970,1596],{"class":1630},[238,2972,258],{"class":244},[238,2974,261],{"class":244},[238,2976,264],{"class":244},[238,2978,1605],{"class":267},[238,2980,258],{"class":244},[238,2982,273],{"class":244},[238,2984,2985,2987,2989,2991,2993],{"class":240,"line":695},[238,2986,1627],{"class":244},[238,2988,1616],{"class":1630},[238,2990,258],{"class":244},[238,2992,261],{"class":244},[238,2994,571],{"class":244},[238,2996,2997,3000,3003,3005,3007,3009,3011,3013],{"class":240,"line":700},[238,2998,2999],{"class":244},"              \"",[238,3001,151],{"class":3002},"su27w",[238,3004,258],{"class":244},[238,3006,261],{"class":244},[238,3008,264],{"class":244},[238,3010,1639],{"class":267},[238,3012,258],{"class":244},[238,3014,273],{"class":244},[238,3016,3017,3019,3021,3023,3025,3027,3029],{"class":240,"line":714},[238,3018,2999],{"class":244},[238,3020,1650],{"class":3002},[238,3022,258],{"class":244},[238,3024,261],{"class":244},[238,3026,264],{"class":244},[238,3028,1659],{"class":267},[238,3030,653],{"class":244},[238,3032,3033],{"class":240,"line":732},[238,3034,3035],{"class":244},"            }\n",[238,3037,3038],{"class":240,"line":737},[238,3039,3040],{"class":244},"          },\n",[238,3042,3043],{"class":240,"line":742},[238,3044,2902],{"class":244},[238,3046,3047,3049,3051,3053,3055,3057],{"class":240,"line":748},[238,3048,1627],{"class":244},[238,3050,1530],{"class":1630},[238,3052,258],{"class":244},[238,3054,261],{"class":244},[238,3056,1688],{"class":606},[238,3058,273],{"class":244},[238,3060,3061,3063,3065,3067,3069,3071,3073,3075],{"class":240,"line":762},[238,3062,1627],{"class":244},[238,3064,153],{"class":1630},[238,3066,258],{"class":244},[238,3068,261],{"class":244},[238,3070,264],{"class":244},[238,3072,650],{"class":267},[238,3074,258],{"class":244},[238,3076,273],{"class":244},[238,3078,3079,3081,3083,3085,3087],{"class":240,"line":777},[238,3080,1627],{"class":244},[238,3082,1564],{"class":1630},[238,3084,258],{"class":244},[238,3086,261],{"class":244},[238,3088,1721],{"class":244},[238,3090,3091,3093,3095,3097,3099,3101,3103,3105],{"class":240,"line":795},[238,3092,1627],{"class":244},[238,3094,1491],{"class":1630},[238,3096,258],{"class":244},[238,3098,261],{"class":244},[238,3100,264],{"class":244},[238,3102,1500],{"class":267},[238,3104,258],{"class":244},[238,3106,273],{"class":244},[238,3108,3109,3111,3113,3115,3117,3119,3121],{"class":240,"line":800},[238,3110,1627],{"class":244},[238,3112,1596],{"class":1630},[238,3114,258],{"class":244},[238,3116,261],{"class":244},[238,3118,264],{"class":244},[238,3120,1462],{"class":267},[238,3122,653],{"class":244},[238,3124,3125],{"class":240,"line":805},[238,3126,1666],{"class":244},[238,3128,3129],{"class":240,"line":819},[238,3130,3131],{"class":244},"        ],\n",[238,3133,3134,3136,3138,3140,3142,3144,3146,3148],{"class":240,"line":843},[238,3135,2745],{"class":244},[238,3137,1772],{"class":606},[238,3139,258],{"class":244},[238,3141,261],{"class":244},[238,3143,264],{"class":244},[238,3145,1781],{"class":267},[238,3147,258],{"class":244},[238,3149,273],{"class":244},[238,3151,3152,3154,3156,3158,3160],{"class":240,"line":865},[238,3153,2745],{"class":244},[238,3155,880],{"class":606},[238,3157,258],{"class":244},[238,3159,261],{"class":244},[238,3161,571],{"class":244},[238,3163,3164,3166,3168,3170,3172,3174,3176],{"class":240,"line":870},[238,3165,1527],{"class":244},[238,3167,894],{"class":1630},[238,3169,258],{"class":244},[238,3171,261],{"class":244},[238,3173,264],{"class":244},[238,3175,903],{"class":267},[238,3177,653],{"class":244},[238,3179,3180],{"class":240,"line":875},[238,3181,1671],{"class":244},[238,3183,3184,3186,3189,3191,3193,3195,3197],{"class":240,"line":889},[238,3185,2745],{"class":244},[238,3187,3188],{"class":606},"completed_at",[238,3190,258],{"class":244},[238,3192,261],{"class":244},[238,3194,264],{"class":244},[238,3196,1801],{"class":267},[238,3198,653],{"class":244},[238,3200,3201],{"class":240,"line":911},[238,3202,3203],{"class":244},"      }\n",[238,3205,3206],{"class":240,"line":917},[238,3207,1808],{"class":244},[238,3209,3211],{"class":240,"line":3210},42,[238,3212,3213],{"class":244},"  ],\n",[238,3215,3217,3219,3221,3223,3225,3227,3229],{"class":240,"line":3216},43,[238,3218,251],{"class":244},[238,3220,1792],{"class":254},[238,3222,258],{"class":244},[238,3224,261],{"class":244},[238,3226,264],{"class":244},[238,3228,1801],{"class":267},[238,3230,653],{"class":244},[238,3232,3234],{"class":240,"line":3233},44,[238,3235,302],{"class":244},[163,3237,3239],{"id":3238},"webhook-payload-parameters","Webhook Payload Parameters",[177,3241,3242,3259],{},[180,3243,3244],{},[183,3245,3246,3251,3253,3257],{},[186,3247,3248],{"align":188},[950,3249,953],{"style":3250},"width:120px",[186,3252,192],{"align":188},[186,3254,3255],{"align":188},[950,3256,195],{"style":963},[186,3258,198],{"align":188},[200,3260,3261,3272,3285,3299,3312,3325,3343,3356,3374,3390,3405,3420,3438,3454,3468],{},[183,3262,3263,3265,3267,3270],{},[205,3264,2660],{"align":188},[205,3266,976],{"align":188},[205,3268,3269],{"align":188},"Type of webhook event that occurred",[205,3271,2664],{"align":188},[183,3273,3274,3276,3278,3281],{},[205,3275,2716],{"align":188},[205,3277,1140],{"align":188},[205,3279,3280],{"align":188},"Array containing charge data",[205,3282,3283],{"align":188},[238,3284,2493],{},[183,3286,3287,3292,3294,3297],{},[205,3288,2716,3289,3291],{"align":188},[238,3290],{},".charge.id",[205,3293,210],{"align":188},[205,3295,3296],{"align":188},"Unique charge identifier",[205,3298,1371],{"align":188},[183,3300,3301,3306,3308,3310],{},[205,3302,2716,3303,3305],{"align":188},[238,3304],{},".charge.customer_id",[205,3307,210],{"align":188},[205,3309,2381],{"align":188},[205,3311,220],{"align":188},[183,3313,3314,3319,3321,3323],{},[205,3315,2716,3316,3318],{"align":188},[238,3317],{},".charge.amount",[205,3320,976],{"align":188},[205,3322,2393],{"align":188},[205,3324,268],{"align":188},[183,3326,3327,3332,3334,3339],{},[205,3328,2716,3329,3331],{"align":188},[238,3330],{},".charge.currency",[205,3333,991],{"align":188},[205,3335,3336,2408],{"align":188},[159,3337,1000],{"href":996,"rel":3338,":target":999},[998],[205,3340,3341],{"align":188},[151,3342,429],{},[183,3344,3345,3350,3352,3354],{},[205,3346,2716,3347,3349],{"align":188},[238,3348],{},".charge.reference",[205,3351,1016],{"align":188},[205,3353,2422],{"align":188},[205,3355,290],{"align":188},[183,3357,3358,3363,3365,3370],{},[205,3359,2716,3360,3362],{"align":188},[238,3361],{},".charge.charge_status",[205,3364,1056],{"align":188},[205,3366,3367,3368],{"align":188},"Overall charge outcome, see ",[159,3369,1173],{"href":1172},[205,3371,3372],{"align":188},[151,3373,1462],{},[183,3375,3376,3381,3383,3388],{},[205,3377,2716,3378,3380],{"align":188},[238,3379],{},".charge.card_id",[205,3382,210],{"align":188},[205,3384,2458,3385,3387],{"align":188},[151,3386,2461],{}," on failure",[205,3389,650],{"align":188},[183,3391,3392,3397,3399,3403],{},[205,3393,2716,3394,3396],{"align":188},[238,3395],{},".charge.transaction_id",[205,3398,210],{"align":188},[205,3400,2474,3401,3387],{"align":188},[151,3402,2461],{},[205,3404,1500],{"align":188},[183,3406,3407,3412,3414,3416],{},[205,3408,2716,3409,3411],{"align":188},[238,3410],{},".charge.attempts",[205,3413,1140],{"align":188},[205,3415,2488],{"align":188},[205,3417,3418],{"align":188},[238,3419,2493],{},[183,3421,3422,3427,3429,3436],{},[205,3423,2716,3424,3426],{"align":188},[238,3425],{},".charge.invoice_id",[205,3428,210],{"align":188},[205,3430,3431,3432,2613,3434,2616],{"align":188},"Invoice identifier when ",[151,3433,1225],{},[151,3435,1108],{},[205,3437,1781],{"align":188},[183,3439,3440,3445,3447,3450],{},[205,3441,2716,3442,3444],{"align":188},[238,3443],{},".charge.metadata",[205,3446,1079],{"align":188},[205,3448,3449],{"align":188},"Custom key\u002Fvalue metadata supplied on create",[205,3451,3452],{"align":188},[151,3453,1298],{},[183,3455,3456,3461,3463,3466],{},[205,3457,2716,3458,3460],{"align":188},[238,3459],{},".charge.completed_at",[205,3462,976],{"align":188},[205,3464,3465],{"align":188},"ISO timestamp when the charge reached its final status",[205,3467,1801],{"align":188},[183,3469,3470,3472,3474,3477],{},[205,3471,1792],{"align":188},[205,3473,976],{"align":188},[205,3475,3476],{"align":188},"ISO timestamp when webhook was created",[205,3478,1801],{"align":188},[163,3480,3482],{"id":3481},"webhook-events","Webhook Events",[177,3484,3485,3500],{},[180,3486,3487],{},[183,3488,3489,3492,3494,3497],{},[186,3490,3491],{"align":188},"Event",[186,3493,195],{"align":188},[186,3495,3496],{"align":188},"Trigger Condition",[186,3498,3499],{"align":188},"Data Included",[200,3501,3502,3520],{},[183,3503,3504,3508,3511,3517],{},[205,3505,3506],{"align":188},[151,3507,2664],{},[205,3509,3510],{"align":188},"The charge succeeded on one of the customer's cards",[205,3512,3513,3514,3516],{"align":188},"When any cascade attempt (or the specified ",[151,3515,153],{},") is authorised",[205,3518,3519],{"align":188},"Charge details, successful transaction, full attempt history, invoice when generated",[183,3521,3522,3526,3529,3535],{},[205,3523,3524],{"align":188},[151,3525,2668],{},[205,3527,3528],{"align":188},"The charge failed on all attempted cards",[205,3530,3531,3532,3534],{"align":188},"When all cascade attempts decline, a hard decline aborts the cascade, or the specified ",[151,3533,153],{}," declines",[205,3536,3537],{"align":188},"Charge details, full attempt history with decline codes",[163,3539,3541],{"id":3540},"webhook-security","Webhook Security",[147,3543,3544],{},"All webhooks are sent with the following headers for verification:",[3546,3547,3548,3555,3561],"ul",{},[3549,3550,3551,3554],"li",{},[151,3552,3553],{},"X-Signature",": HMAC-SHA256 signature of the payload",[3549,3556,3557,3560],{},[151,3558,3559],{},"X-Timestamp",": Unix timestamp of when the webhook was sent",[3549,3562,3563,3566,3567],{},[151,3564,3565],{},"User-Agent",": ",[151,3568,3569],{},"Kwik-Webhooks\u002F1.0",[163,3571,3573],{"id":3572},"webhook-response","Webhook Response",[147,3575,3576,3577,3580],{},"Your endpoint should respond with a ",[151,3578,3579],{},"200"," status code to acknowledge receipt. Failed webhooks will be retried up to 3 times with exponential backoff.",[3582,3583,3584],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .su27w, html code.shiki .su27w{--shiki-light:#916B53;--shiki-default:#916B53;--shiki-dark:#916B53}",{"title":234,"searchDepth":241,"depth":248,"links":3586},[3587,3596,3597],{"id":144,"depth":248,"text":145,"children":3588},[3589,3590,3591,3592,3593,3594,3595],{"id":165,"depth":276,"text":166},{"id":223,"depth":276,"text":224},{"id":305,"depth":276,"text":306},{"id":382,"depth":276,"text":383},{"id":922,"depth":276,"text":923},{"id":1301,"depth":276,"text":1302},{"id":2327,"depth":276,"text":2328},{"id":2633,"depth":248,"text":2634},{"id":2323,"depth":248,"text":2648,"children":3598},[3599,3600,3601,3602,3603],{"id":2676,"depth":276,"text":2677},{"id":3238,"depth":276,"text":3239},{"id":3481,"depth":276,"text":3482},{"id":3540,"depth":276,"text":3541},{"id":3572,"depth":276,"text":3573},"Charge a customer's stored cards server-to-server. Attempts the default card first with automatic cascade to fallback cards, or targets a specific card. Supports merchant-initiated (MIT) scheme compliance, invoice issuance, synchronous and asynchronous processing, and webhook notifications.","md",null,{},{"title":95,"description":3604},"TN4VRsNS2UYl8X0irjR0OEN3dTeDW138cQp3FrHiMzM",[3611,3613],{"title":91,"path":92,"stem":93,"description":3612,"children":-1},"Create a secure, customizable link session for a customer to store or manage cards in the card vault. Cards are tokenized and verified with 3D Secure authentication, with an optional one-time fee, support for default and fallback card ordering, and webhook notifications.",{"title":104,"path":105,"stem":106,"description":3614,"children":-1},"Send money to customer bank accounts and manage outbound transfers. Create single or batch payouts with real-time status tracking, beneficiary management, and comprehensive transaction reporting.",1783236293816]