[{"data":1,"prerenderedAt":5732},["ShallowReactive",2],{"navigation-docs_v2":3,"\u002Fv2\u002Fmoney-in\u002Fcard-vault-pre-auth":148,"\u002Fv2\u002Fmoney-in\u002Fcard-vault-pre-auth-surround":5727},[4],{"title":5,"path":6,"stem":7,"children":8,"page":68},"V2","\u002Fv2","v2",[9,27,69,106,123,140],{"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,98,102],{"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},"Subscriptions","\u002Fv2\u002Fmoney-in\u002Fsubscriptions","v2\u002F3.money-in\u002F3.subscriptions",{"title":87,"path":88,"stem":89},"Checkout Link","\u002Fv2\u002Fmoney-in\u002Fcheckout-link","v2\u002F3.money-in\u002F4.checkout-link",{"title":91,"path":92,"stem":93},"Checkout Form","\u002Fv2\u002Fmoney-in\u002Fcheckout-form","v2\u002F3.money-in\u002F5.checkout-form",{"title":95,"path":96,"stem":97},"Card Vault Link","\u002Fv2\u002Fmoney-in\u002Fcard-vault-link","v2\u002F3.money-in\u002F6.card-vault-link",{"title":99,"path":100,"stem":101},"Card Vault Charge","\u002Fv2\u002Fmoney-in\u002Fcard-vault-charge","v2\u002F3.money-in\u002F7.card-vault-charge",{"title":103,"path":104,"stem":105},"Card Vault Pre-Auth","\u002Fv2\u002Fmoney-in\u002Fcard-vault-pre-auth","v2\u002F3.money-in\u002F8.card-vault-pre-auth",{"title":107,"path":108,"stem":109,"children":110,"page":68},"Money Out","\u002Fv2\u002Fmoney-out","v2\u002F4.money-out",[111,115,119],{"title":112,"path":113,"stem":114},"Payouts","\u002Fv2\u002Fmoney-out\u002Fpayouts","v2\u002F4.money-out\u002F1.payouts",{"title":116,"path":117,"stem":118},"Recipients","\u002Fv2\u002Fmoney-out\u002Frecipients","v2\u002F4.money-out\u002F2.recipients",{"title":120,"path":121,"stem":122},"Refunds","\u002Fv2\u002Fmoney-out\u002Frefunds","v2\u002F4.money-out\u002F3.refunds",{"title":124,"path":125,"stem":126,"children":127,"page":68},"Verification","\u002Fv2\u002Fverification","v2\u002F5.verification",[128,132,136],{"title":129,"path":130,"stem":131},"CDV","\u002Fv2\u002Fverification\u002Fcdv","v2\u002F5.verification\u002F1.cdv",{"title":133,"path":134,"stem":135},"AVS-R","\u002Fv2\u002Fverification\u002Favs-r","v2\u002F5.verification\u002F2.avs-r",{"title":137,"path":138,"stem":139},"SDO","\u002Fv2\u002Fverification\u002Fsdo","v2\u002F5.verification\u002F3.sdo",{"title":141,"path":142,"stem":143,"children":144,"page":68},"Webhooks","\u002Fv2\u002Fwebhooks","v2\u002F6.webhooks",[145],{"title":141,"path":146,"stem":147},"\u002Fv2\u002Fwebhooks\u002Fwebhooks","v2\u002F6.webhooks\u002F1.webhooks",{"id":149,"title":103,"body":150,"description":5721,"extension":5722,"links":5723,"meta":5724,"navigation":579,"path":104,"seo":5725,"stem":105,"__hash__":5726},"docs_v2\u002Fv2\u002F3.money-in\u002F8.card-vault-pre-auth.md",{"type":151,"value":152,"toc":5687},"minimark",[153,158,167,174,199,204,213,258,262,265,363,367,370,456,460,463,1058,1062,1079,1495,1499,1522,1525,2014,2017,2505,2509,2812,2816,2833,2836,2843,2870,2874,2881,2914,2918,2921,2953,3258,3261,3486,3489,3751,3754,3935,3939,3950,3953,3960,3986,3989,3994,4113,4116,4194,4197,4417,4420,4569,4573,4584,4588,4594,4622,4626,5239,5243,5535,5539,5640,5644,5647,5672,5676,5683],[154,155,157],"h2",{"id":156},"pre-auth-request","Pre-Auth Request",[159,160,161,162,166],"p",{},"Request to place a pre-authorisation hold on a customer's vaulted card(s). Funds are reserved on the cardholder's account but not settled until captured. By default the customer's default card is attempted first, cascading through the remaining active cards in priority order until an authorisation succeeds or all cards are exhausted. Pass ",[163,164,165],"code",{},"card_id"," to authorise a specific card only (no cascade).",[159,168,169,170,173],{},"Pre-auths are processed as merchant-initiated transactions (MIT) — no 3DS challenge is presented. The 3DS authentication from the original card storage (see ",[171,172,95],"a",{"href":96},") provides the authentication reference for scheme compliance.",[159,175,176,177,180,181,184,185,189,190,194,195,198],{},"A successful pre-auth returns a ",[163,178,179],{},"transaction_id"," (",[163,182,183],{},"tra_","), which is then used to ",[171,186,188],{"href":187},"#capture-request","capture"," or ",[171,191,193],{"href":192},"#reverse-request","reverse"," the hold. Holds that are neither captured nor reversed expire automatically at ",[163,196,197],{},"expires_at"," (7 days by default) and the funds are released.",[200,201,203],"h3",{"id":202},"path","Path",[159,205,206,209,210],{},[163,207,208],{},"POST"," ",[163,211,212],{},"\u002Fcard-vault\u002F{customer_id}\u002Fpre-auth",[214,215,216,236],"table",{},[217,218,219],"thead",{},[220,221,222,227,230,233],"tr",{},[223,224,226],"th",{"align":225},"left","Path Parameter",[223,228,229],{"align":225},"Type",[223,231,232],{"align":225},"Description",[223,234,235],{"align":225},"Example",[237,238,239],"tbody",{},[220,240,241,245,248,255],{},[242,243,244],"td",{"align":225},"customer_id",[242,246,247],{"align":225},"String(32)",[242,249,250,251],{"align":225},"The customer whose stored cards will be authorised — see ",[171,252,254],{"href":253},"\u002Freference\u002Fcustomers","customers",[242,256,257],{"align":225},"cus_abc123...",[200,259,261],{"id":260},"example-basic","Example (Basic)",[159,263,264],{},"Basic example to pre-authorise the customer. The default card is attempted first, then the remaining active cards in priority order.",[266,267,272],"pre",{"className":268,"code":269,"language":270,"meta":271,"style":271},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"item\": {\n    \"amount\": \"349.00\" \u002F\u002F amount to place on hold\n  },\n  \"reference\": \"INV-2026-00042\" \u002F\u002F your reference; appears on statements and reporting\n}\n","json","",[163,273,274,283,302,329,335,357],{"__ignoreMap":271},[275,276,279],"span",{"class":277,"line":278},"line",1,[275,280,282],{"class":281},"sMK4o","{\n",[275,284,286,289,293,296,299],{"class":277,"line":285},2,[275,287,288],{"class":281},"  \"",[275,290,292],{"class":291},"spNyl","item",[275,294,295],{"class":281},"\"",[275,297,298],{"class":281},":",[275,300,301],{"class":281}," {\n",[275,303,305,308,312,314,316,319,323,325],{"class":277,"line":304},3,[275,306,307],{"class":281},"    \"",[275,309,311],{"class":310},"sBMFI","amount",[275,313,295],{"class":281},[275,315,298],{"class":281},[275,317,318],{"class":281}," \"",[275,320,322],{"class":321},"sfazB","349.00",[275,324,295],{"class":281},[275,326,328],{"class":327},"sHwdD"," \u002F\u002F amount to place on hold\n",[275,330,332],{"class":277,"line":331},4,[275,333,334],{"class":281},"  },\n",[275,336,338,340,343,345,347,349,352,354],{"class":277,"line":337},5,[275,339,288],{"class":281},[275,341,342],{"class":291},"reference",[275,344,295],{"class":281},[275,346,298],{"class":281},[275,348,318],{"class":281},[275,350,351],{"class":321},"INV-2026-00042",[275,353,295],{"class":281},[275,355,356],{"class":327}," \u002F\u002F your reference; appears on statements and reporting\n",[275,358,360],{"class":277,"line":359},6,[275,361,362],{"class":281},"}\n",[200,364,366],{"id":365},"example-specific-card","Example (Specific card)",[159,368,369],{},"Pre-authorise one specific stored card only. The cascade is disabled — if this card declines, the pre-auth fails.",[266,371,373],{"className":268,"code":372,"language":270,"meta":271,"style":271},"{\n  \"item\": {\n    \"amount\": \"349.00\"\n  },\n  \"reference\": \"INV-2026-00042\",\n  \"card_id\": \"crd_SFq2E9LskQimPkf2mRqnV\" \u002F\u002F authorise this card only; obtain card IDs from the card vault webhooks or the customer's card list\n}\n",[163,374,375,379,391,408,412,431,451],{"__ignoreMap":271},[275,376,377],{"class":277,"line":278},[275,378,282],{"class":281},[275,380,381,383,385,387,389],{"class":277,"line":285},[275,382,288],{"class":281},[275,384,292],{"class":291},[275,386,295],{"class":281},[275,388,298],{"class":281},[275,390,301],{"class":281},[275,392,393,395,397,399,401,403,405],{"class":277,"line":304},[275,394,307],{"class":281},[275,396,311],{"class":310},[275,398,295],{"class":281},[275,400,298],{"class":281},[275,402,318],{"class":281},[275,404,322],{"class":321},[275,406,407],{"class":281},"\"\n",[275,409,410],{"class":277,"line":331},[275,411,334],{"class":281},[275,413,414,416,418,420,422,424,426,428],{"class":277,"line":337},[275,415,288],{"class":281},[275,417,342],{"class":291},[275,419,295],{"class":281},[275,421,298],{"class":281},[275,423,318],{"class":281},[275,425,351],{"class":321},[275,427,295],{"class":281},[275,429,430],{"class":281},",\n",[275,432,433,435,437,439,441,443,446,448],{"class":277,"line":359},[275,434,288],{"class":281},[275,436,165],{"class":291},[275,438,295],{"class":281},[275,440,298],{"class":281},[275,442,318],{"class":281},[275,444,445],{"class":321},"crd_SFq2E9LskQimPkf2mRqnV",[275,447,295],{"class":281},[275,449,450],{"class":327}," \u002F\u002F authorise this card only; obtain card IDs from the card vault webhooks or the customer's card list\n",[275,452,454],{"class":277,"line":453},7,[275,455,362],{"class":281},[200,457,459],{"id":458},"example-advanced","Example (Advanced)",[159,461,462],{},"Advanced example with all options, including cascade controls and hold duration.",[266,464,466],{"className":268,"code":465,"language":270,"meta":271,"style":271},"{\n  \"item\": {\n    \"amount\": \"349.00\",\n    \"title\": \"Booking deposit\", \u002F\u002F [optional] carried through as the default invoice line when the hold is captured with an invoice\n    \"description\": \"Room 12, 3 nights\" \u002F\u002F [optional]\n  },\n  \"currency\": \"ZAR\", \u002F\u002F [optional] default \"ZAR\"\n\n  \"reference\": \"INV-2026-00042\", \u002F\u002F your reference; appears on statements and reporting\n\n  \"expires_in_days\": 7, \u002F\u002F [optional] default 7 — days before an uncaptured hold is automatically released (1–30, scheme limits apply)\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 [optional] catalog invoice lines, carried through as the default lines when the hold is captured with an invoice —\n  \u002F\u002F overrides the default single line from item; can be overridden at capture\n  \"items\": [\n    {\n      \"product_id\": \"pro_abc123...\",\n      \"qty\": 2 \u002F\u002F default 1 when omitted\n    },\n    {\n      \"product_id\": \"pro_xyz789...\",\n      \"price_excl\": 300.23 \u002F\u002F override the default product amount\n    }\n  ],\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  \"notification\": {\n    \"email\": \"me@my-email.co.za\", \u002F\u002F [optional] email notification on the pre-auth outcome\n    \"webhook_url\": \"https:\u002F\u002Fmerchant.example\u002Fwebhooks\u002Fpayments\" \u002F\u002F webhook on preauth.successful \u002F preauth.failed \u002F preauth.captured \u002F preauth.reversed \u002F preauth.expired\n  },\n\n  \"metadata\": {\n    \"order_id\": \"ord_98765\" \u002F\u002F [optional] custom key\u002Fvalue pairs returned on the pre-auth and webhooks\n  }\n}\n",[163,467,468,472,484,502,526,547,551,574,581,602,607,628,633,657,662,668,674,689,695,717,735,741,746,766,784,790,796,801,807,821,839,859,877,888,898,904,931,936,941,955,979,1001,1006,1011,1025,1047,1053],{"__ignoreMap":271},[275,469,470],{"class":277,"line":278},[275,471,282],{"class":281},[275,473,474,476,478,480,482],{"class":277,"line":285},[275,475,288],{"class":281},[275,477,292],{"class":291},[275,479,295],{"class":281},[275,481,298],{"class":281},[275,483,301],{"class":281},[275,485,486,488,490,492,494,496,498,500],{"class":277,"line":304},[275,487,307],{"class":281},[275,489,311],{"class":310},[275,491,295],{"class":281},[275,493,298],{"class":281},[275,495,318],{"class":281},[275,497,322],{"class":321},[275,499,295],{"class":281},[275,501,430],{"class":281},[275,503,504,506,509,511,513,515,518,520,523],{"class":277,"line":331},[275,505,307],{"class":281},[275,507,508],{"class":310},"title",[275,510,295],{"class":281},[275,512,298],{"class":281},[275,514,318],{"class":281},[275,516,517],{"class":321},"Booking deposit",[275,519,295],{"class":281},[275,521,522],{"class":281},",",[275,524,525],{"class":327}," \u002F\u002F [optional] carried through as the default invoice line when the hold is captured with an invoice\n",[275,527,528,530,533,535,537,539,542,544],{"class":277,"line":337},[275,529,307],{"class":281},[275,531,532],{"class":310},"description",[275,534,295],{"class":281},[275,536,298],{"class":281},[275,538,318],{"class":281},[275,540,541],{"class":321},"Room 12, 3 nights",[275,543,295],{"class":281},[275,545,546],{"class":327}," \u002F\u002F [optional]\n",[275,548,549],{"class":277,"line":359},[275,550,334],{"class":281},[275,552,553,555,558,560,562,564,567,569,571],{"class":277,"line":453},[275,554,288],{"class":281},[275,556,557],{"class":291},"currency",[275,559,295],{"class":281},[275,561,298],{"class":281},[275,563,318],{"class":281},[275,565,566],{"class":321},"ZAR",[275,568,295],{"class":281},[275,570,522],{"class":281},[275,572,573],{"class":327}," \u002F\u002F [optional] default \"ZAR\"\n",[275,575,577],{"class":277,"line":576},8,[275,578,580],{"emptyLinePlaceholder":579},true,"\n",[275,582,584,586,588,590,592,594,596,598,600],{"class":277,"line":583},9,[275,585,288],{"class":281},[275,587,342],{"class":291},[275,589,295],{"class":281},[275,591,298],{"class":281},[275,593,318],{"class":281},[275,595,351],{"class":321},[275,597,295],{"class":281},[275,599,522],{"class":281},[275,601,356],{"class":327},[275,603,605],{"class":277,"line":604},10,[275,606,580],{"emptyLinePlaceholder":579},[275,608,610,612,615,617,619,623,625],{"class":277,"line":609},11,[275,611,288],{"class":281},[275,613,614],{"class":291},"expires_in_days",[275,616,295],{"class":281},[275,618,298],{"class":281},[275,620,622],{"class":621},"sbssI"," 7",[275,624,522],{"class":281},[275,626,627],{"class":327}," \u002F\u002F [optional] default 7 — days before an uncaptured hold is automatically released (1–30, scheme limits apply)\n",[275,629,631],{"class":277,"line":630},12,[275,632,580],{"emptyLinePlaceholder":579},[275,634,636,638,641,643,645,647,650,652,654],{"class":277,"line":635},13,[275,637,288],{"class":281},[275,639,640],{"class":291},"signature",[275,642,295],{"class":281},[275,644,298],{"class":281},[275,646,318],{"class":281},[275,648,649],{"class":321},"secret-key-for-payload",[275,651,295],{"class":281},[275,653,522],{"class":281},[275,655,656],{"class":327}," \u002F\u002F [optional] shared-secret signature for the payload, see the signature section below\n",[275,658,660],{"class":277,"line":659},14,[275,661,580],{"emptyLinePlaceholder":579},[275,663,665],{"class":277,"line":664},15,[275,666,667],{"class":327},"  \u002F\u002F [optional] catalog invoice lines, carried through as the default lines when the hold is captured with an invoice —\n",[275,669,671],{"class":277,"line":670},16,[275,672,673],{"class":327},"  \u002F\u002F overrides the default single line from item; can be overridden at capture\n",[275,675,677,679,682,684,686],{"class":277,"line":676},17,[275,678,288],{"class":281},[275,680,681],{"class":291},"items",[275,683,295],{"class":281},[275,685,298],{"class":281},[275,687,688],{"class":281}," [\n",[275,690,692],{"class":277,"line":691},18,[275,693,694],{"class":281},"    {\n",[275,696,698,701,704,706,708,710,713,715],{"class":277,"line":697},19,[275,699,700],{"class":281},"      \"",[275,702,703],{"class":310},"product_id",[275,705,295],{"class":281},[275,707,298],{"class":281},[275,709,318],{"class":281},[275,711,712],{"class":321},"pro_abc123...",[275,714,295],{"class":281},[275,716,430],{"class":281},[275,718,720,722,725,727,729,732],{"class":277,"line":719},20,[275,721,700],{"class":281},[275,723,724],{"class":310},"qty",[275,726,295],{"class":281},[275,728,298],{"class":281},[275,730,731],{"class":621}," 2",[275,733,734],{"class":327}," \u002F\u002F default 1 when omitted\n",[275,736,738],{"class":277,"line":737},21,[275,739,740],{"class":281},"    },\n",[275,742,744],{"class":277,"line":743},22,[275,745,694],{"class":281},[275,747,749,751,753,755,757,759,762,764],{"class":277,"line":748},23,[275,750,700],{"class":281},[275,752,703],{"class":310},[275,754,295],{"class":281},[275,756,298],{"class":281},[275,758,318],{"class":281},[275,760,761],{"class":321},"pro_xyz789...",[275,763,295],{"class":281},[275,765,430],{"class":281},[275,767,769,771,774,776,778,781],{"class":277,"line":768},24,[275,770,700],{"class":281},[275,772,773],{"class":310},"price_excl",[275,775,295],{"class":281},[275,777,298],{"class":281},[275,779,780],{"class":621}," 300.23",[275,782,783],{"class":327}," \u002F\u002F override the default product amount\n",[275,785,787],{"class":277,"line":786},25,[275,788,789],{"class":281},"    }\n",[275,791,793],{"class":277,"line":792},26,[275,794,795],{"class":281},"  ],\n",[275,797,799],{"class":277,"line":798},27,[275,800,580],{"emptyLinePlaceholder":579},[275,802,804],{"class":277,"line":803},28,[275,805,806],{"class":327},"  \u002F\u002F Cascade behaviour — ignored when card_id is passed\n",[275,808,810,812,815,817,819],{"class":277,"line":809},29,[275,811,288],{"class":281},[275,813,814],{"class":291},"cascade",[275,816,295],{"class":281},[275,818,298],{"class":281},[275,820,301],{"class":281},[275,822,824,826,829,831,833,836],{"class":277,"line":823},30,[275,825,307],{"class":281},[275,827,828],{"class":310},"is_enabled",[275,830,295],{"class":281},[275,832,298],{"class":281},[275,834,835],{"class":281}," true,",[275,837,838],{"class":327}," \u002F\u002F [optional] default true — when false, only the default card is attempted\n",[275,840,842,844,847,849,851,854,856],{"class":277,"line":841},31,[275,843,307],{"class":281},[275,845,846],{"class":310},"max_attempts",[275,848,295],{"class":281},[275,850,298],{"class":281},[275,852,853],{"class":621}," 3",[275,855,522],{"class":281},[275,857,858],{"class":327}," \u002F\u002F [optional] cap on the number of cards tried; defaults to all ACTIVE cards\n",[275,860,862,864,867,869,871,874],{"class":277,"line":861},32,[275,863,307],{"class":281},[275,865,866],{"class":310},"card_order",[275,868,295],{"class":281},[275,870,298],{"class":281},[275,872,873],{"class":281}," [",[275,875,876],{"class":327}," \u002F\u002F [optional] explicit order override; defaults to: default card first, then by priority\n",[275,878,880,882,884,886],{"class":277,"line":879},33,[275,881,700],{"class":281},[275,883,445],{"class":321},[275,885,295],{"class":281},[275,887,430],{"class":281},[275,889,891,893,896],{"class":277,"line":890},34,[275,892,700],{"class":281},[275,894,895],{"class":321},"crd_9kLmXw3RtYqPz8vNcE2aB",[275,897,407],{"class":281},[275,899,901],{"class":277,"line":900},35,[275,902,903],{"class":281},"    ],\n",[275,905,907,909,912,914,916,918,920,923,925,928],{"class":277,"line":906},36,[275,908,307],{"class":281},[275,910,911],{"class":310},"skip_codes",[275,913,295],{"class":281},[275,915,298],{"class":281},[275,917,873],{"class":281},[275,919,295],{"class":281},[275,921,922],{"class":321},"DO_NOT_HONOUR",[275,924,295],{"class":281},[275,926,927],{"class":281},"]",[275,929,930],{"class":327}," \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",[275,932,934],{"class":277,"line":933},37,[275,935,334],{"class":281},[275,937,939],{"class":277,"line":938},38,[275,940,580],{"emptyLinePlaceholder":579},[275,942,944,946,949,951,953],{"class":277,"line":943},39,[275,945,288],{"class":281},[275,947,948],{"class":291},"notification",[275,950,295],{"class":281},[275,952,298],{"class":281},[275,954,301],{"class":281},[275,956,958,960,963,965,967,969,972,974,976],{"class":277,"line":957},40,[275,959,307],{"class":281},[275,961,962],{"class":310},"email",[275,964,295],{"class":281},[275,966,298],{"class":281},[275,968,318],{"class":281},[275,970,971],{"class":321},"me@my-email.co.za",[275,973,295],{"class":281},[275,975,522],{"class":281},[275,977,978],{"class":327}," \u002F\u002F [optional] email notification on the pre-auth outcome\n",[275,980,982,984,987,989,991,993,996,998],{"class":277,"line":981},41,[275,983,307],{"class":281},[275,985,986],{"class":310},"webhook_url",[275,988,295],{"class":281},[275,990,298],{"class":281},[275,992,318],{"class":281},[275,994,995],{"class":321},"https:\u002F\u002Fmerchant.example\u002Fwebhooks\u002Fpayments",[275,997,295],{"class":281},[275,999,1000],{"class":327}," \u002F\u002F webhook on preauth.successful \u002F preauth.failed \u002F preauth.captured \u002F preauth.reversed \u002F preauth.expired\n",[275,1002,1004],{"class":277,"line":1003},42,[275,1005,334],{"class":281},[275,1007,1009],{"class":277,"line":1008},43,[275,1010,580],{"emptyLinePlaceholder":579},[275,1012,1014,1016,1019,1021,1023],{"class":277,"line":1013},44,[275,1015,288],{"class":281},[275,1017,1018],{"class":291},"metadata",[275,1020,295],{"class":281},[275,1022,298],{"class":281},[275,1024,301],{"class":281},[275,1026,1028,1030,1033,1035,1037,1039,1042,1044],{"class":277,"line":1027},45,[275,1029,307],{"class":281},[275,1031,1032],{"class":310},"order_id",[275,1034,295],{"class":281},[275,1036,298],{"class":281},[275,1038,318],{"class":281},[275,1040,1041],{"class":321},"ord_98765",[275,1043,295],{"class":281},[275,1045,1046],{"class":327}," \u002F\u002F [optional] custom key\u002Fvalue pairs returned on the pre-auth and webhooks\n",[275,1048,1050],{"class":277,"line":1049},46,[275,1051,1052],{"class":281},"  }\n",[275,1054,1056],{"class":277,"line":1055},47,[275,1057,362],{"class":281},[200,1059,1061],{"id":1060},"request-parameters","Request Parameters",[159,1063,1064,1065,1069,1070,1074,1075,1078],{},"Fields below appear in the ",[171,1066,1068],{"href":1067},"#example-basic","request body examples"," on this page. ",[1071,1072,1073],"strong",{},"Y"," = required for all requests, ",[1071,1076,1077],{},"C"," = required or applicable depending on usage.",[214,1080,1081,1104],{},[217,1082,1083],{},[220,1084,1085,1092,1095,1097,1102],{},[223,1086,1087],{"align":225},[1088,1089,1091],"div",{"style":1090},"width:100px","Field",[223,1093,1094],{"align":225},"Required",[223,1096,229],{"align":225},[223,1098,1099],{"align":225},[1088,1100,232],{"style":1101},"width:300px",[223,1103,235],{"align":225},[237,1105,1106,1121,1136,1158,1172,1197,1211,1224,1249,1274,1290,1310,1328,1344,1366,1385,1400,1432,1445,1462,1479],{},[220,1107,1108,1110,1112,1115,1118],{},[242,1109,292],{"align":225},[242,1111,1073],{"align":225},[242,1113,1114],{"align":225},"Object",[242,1116,1117],{"align":225},"Hold amount and payer-facing details",[242,1119,1120],{"align":225},"See basic example",[220,1122,1123,1126,1128,1131,1134],{},[242,1124,1125],{"align":225},"item.amount",[242,1127,1073],{"align":225},[242,1129,1130],{"align":225},"String",[242,1132,1133],{"align":225},"Amount to place on hold",[242,1135,322],{"align":225},[220,1137,1138,1141,1144,1146,1156],{},[242,1139,1140],{"align":225},"item.title",[242,1142,1143],{"align":225},"N",[242,1145,1130],{"align":225},[242,1147,1148,1149,1152,1153,1155],{"align":225},"Line item title, carried through as the default invoice line when the hold is ",[171,1150,1151],{"href":187},"captured"," with an invoice; defaults to ",[163,1154,342],{}," when omitted",[242,1157,517],{"align":225},[220,1159,1160,1163,1165,1167,1170],{},[242,1161,1162],{"align":225},"item.description",[242,1164,1143],{"align":225},[242,1166,1130],{"align":225},[242,1168,1169],{"align":225},"Optional longer line item description",[242,1171,541],{"align":225},[220,1173,1174,1176,1178,1181,1193],{},[242,1175,557],{"align":225},[242,1177,1143],{"align":225},[242,1179,1180],{"align":225},"String(3)",[242,1182,1183,1190,1191],{"align":225},[171,1184,1189],{"href":1185,"rel":1186,":target":1188},"https:\u002F\u002Fen.wikipedia.org\u002Fwiki\u002FISO_4217",[1187],"nofollow","_blank","ISO 4217"," currency code. Default ",[163,1192,566],{},[242,1194,1195],{"align":225},[163,1196,566],{},[220,1198,1199,1201,1203,1206,1209],{},[242,1200,342],{"align":225},[242,1202,1073],{"align":225},[242,1204,1205],{"align":225},"String(35)",[242,1207,1208],{"align":225},"Your reference for this pre-auth; appears on statements and reporting. Must be unique per pre-auth to support idempotent retries",[242,1210,351],{"align":225},[220,1212,1213,1215,1217,1219,1222],{},[242,1214,165],{"align":225},[242,1216,1077],{"align":225},[242,1218,247],{"align":225},[242,1220,1221],{"align":225},"Authorise this specific card only; the cascade is disabled. Omit to authorise the customer with cascade",[242,1223,445],{"align":225},[220,1225,1226,1228,1230,1233,1247],{},[242,1227,614],{"align":225},[242,1229,1143],{"align":225},[242,1231,1232],{"align":225},"Integer",[242,1234,1235,1236,1239,1240,1243,1244],{"align":225},"Days before an uncaptured hold is automatically released (",[163,1237,1238],{},"1","–",[163,1241,1242],{},"30","; card scheme limits apply). Default ",[163,1245,1246],{},"7",[242,1248,1246],{"align":225},[220,1250,1251,1253,1255,1258,1271],{},[242,1252,681],{"align":225},[242,1254,1143],{"align":225},[242,1256,1257],{"align":225},"Array",[242,1259,1260,1261,1263,1264,1266,1267],{"align":225},"Invoice line items from your catalog, carried through as the default lines when the hold is ",[171,1262,1151],{"href":187}," with an invoice; overrides the default single line from ",[163,1265,292],{},". Can be overridden at capture — see ",[171,1268,1270],{"href":1269},"\u002Freference\u002Fproducts","products",[242,1272,1273],{"align":225},"See advanced example",[220,1275,1276,1281,1283,1285,1288],{},[242,1277,681,1278,1280],{"align":225},[275,1279],{},".product_id",[242,1282,1073],{"align":225},[242,1284,1130],{"align":225},[242,1286,1287],{"align":225},"Catalog product for this line",[242,1289,712],{"align":225},[220,1291,1292,1297,1299,1301,1307],{},[242,1293,681,1294,1296],{"align":225},[275,1295],{},".qty",[242,1298,1143],{"align":225},[242,1300,1232],{"align":225},[242,1302,1303,1304,1306],{"align":225},"Quantity for this line item (default ",[163,1305,1238],{},")",[242,1308,1309],{"align":225},"2",[220,1311,1312,1317,1319,1322,1325],{},[242,1313,681,1314,1316],{"align":225},[275,1315],{},".price_excl",[242,1318,1143],{"align":225},[242,1320,1321],{"align":225},"Number",[242,1323,1324],{"align":225},"Override the default product amount (excluding tax)",[242,1326,1327],{"align":225},"300.23",[220,1329,1330,1332,1334,1336,1342],{},[242,1331,814],{"align":225},[242,1333,1143],{"align":225},[242,1335,1114],{"align":225},[242,1337,1338,1339,1341],{"align":225},"Cascade behaviour; ignored when ",[163,1340,165],{}," is passed",[242,1343,1273],{"align":225},[220,1345,1346,1349,1351,1354,1364],{},[242,1347,1348],{"align":225},"cascade.is_enabled",[242,1350,1143],{"align":225},[242,1352,1353],{"align":225},"Boolean",[242,1355,1356,1357,1360,1361],{"align":225},"When ",[163,1358,1359],{},"false",", only the default card is attempted. Default ",[163,1362,1363],{},"true",[242,1365,1363],{"align":225},[220,1367,1368,1371,1373,1375,1382],{},[242,1369,1370],{"align":225},"cascade.max_attempts",[242,1372,1143],{"align":225},[242,1374,1232],{"align":225},[242,1376,1377,1378,1381],{"align":225},"Cap on the number of cards tried; defaults to all ",[163,1379,1380],{},"ACTIVE"," cards",[242,1383,1384],{"align":225},"3",[220,1386,1387,1390,1392,1394,1397],{},[242,1388,1389],{"align":225},"cascade.card_order",[242,1391,1143],{"align":225},[242,1393,1257],{"align":225},[242,1395,1396],{"align":225},"Explicit card order override; defaults to the default card first, then by priority",[242,1398,1399],{"align":225},"[crd_SFq2..., crd_9kLm...]",[220,1401,1402,1405,1407,1409,1427],{},[242,1403,1404],{"align":225},"cascade.skip_codes",[242,1406,1143],{"align":225},[242,1408,1257],{"align":225},[242,1410,1411,1412,1415,1416,1415,1419,1422,1423],{"align":225},"Additional decline codes that abort the cascade instead of trying the next card. Hard declines (",[163,1413,1414],{},"SUSPECTED_FRAUD",", ",[163,1417,1418],{},"STOLEN_CARD",[163,1420,1421],{},"PICKUP_CARD",") always abort and cannot be overridden — see ",[171,1424,1426],{"href":1425},"\u002Freference\u002Flookups","lookups",[242,1428,1429,1430,927],{"align":225},"[",[163,1431,922],{},[220,1433,1434,1436,1438,1440,1443],{},[242,1435,640],{"align":225},[242,1437,1143],{"align":225},[242,1439,1130],{"align":225},[242,1441,1442],{"align":225},"Optional passphrase signature for verifying the payload",[242,1444,649],{"align":225},[220,1446,1447,1450,1452,1454,1457],{},[242,1448,1449],{"align":225},"notification.email",[242,1451,1143],{"align":225},[242,1453,1130],{"align":225},[242,1455,1456],{"align":225},"Email address to notify on the pre-auth outcome",[242,1458,1459],{"align":225},[171,1460,971],{"href":1461},"mailto:me@my-email.co.za",[220,1463,1464,1467,1469,1471,1474],{},[242,1465,1466],{"align":225},"notification.webhook_url",[242,1468,1143],{"align":225},[242,1470,1130],{"align":225},[242,1472,1473],{"align":225},"Webhook URL for the pre-auth lifecycle events",[242,1475,1476],{"align":225},[171,1477,995],{"href":995,"rel":1478},[1187],[220,1480,1481,1483,1485,1487,1490],{},[242,1482,1018],{"align":225},[242,1484,1143],{"align":225},[242,1486,1114],{"align":225},[242,1488,1489],{"align":225},"Custom key\u002Fvalue metadata returned on the pre-auth and webhooks",[242,1491,1492],{"align":225},[163,1493,1494],{},"{\"order_id\": \"ord_98765\"}",[200,1496,1498],{"id":1497},"response-body","Response Body",[159,1500,1501,1502,1505,1506,1508,1509,1512,1513,1515,1516,1518,1519,1521],{},"A pre-auth (",[163,1503,1504],{},"pre_",") wraps one or more card transactions (",[163,1507,183],{},"). Every attempt — including declines — is a real transaction with its own identifier, listed in ",[163,1510,1511],{},"attempts"," in the order they were tried. The ",[163,1514,179],{}," of the successful attempt is the identifier you pass to the ",[171,1517,188],{"href":187}," and ",[171,1520,193],{"href":192}," endpoints.",[159,1523,1524],{},"Example where the default card declined and the second card was authorised:",[266,1526,1528],{"className":268,"code":1527,"language":270,"meta":271,"style":271},"{\n    \"status\": true,\n    \"result\": {\n      \"id\": \"pre_Wt5RmK2xPqLv9nYcE7aBz\",\n      \"customer_id\": \"cus_abc123...\",\n      \"amount\": \"349.00\",\n      \"currency\": \"ZAR\",\n      \"reference\": \"INV-2026-00042\",\n      \"pre_auth_status\": \"AUTHORISED\",\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\": \"AUTHORISED\"\n        }\n      ],\n      \"expires_at\": \"2026-07-13T10:15:30Z\",\n      \"created_at\": \"2026-07-06T10:15:30Z\"\n    }\n}\n",[163,1529,1530,1534,1548,1561,1581,1599,1617,1635,1653,1673,1691,1710,1722,1727,1744,1762,1775,1794,1814,1827,1848,1866,1871,1876,1880,1894,1912,1925,1943,1959,1964,1969,1988,2006,2010],{"__ignoreMap":271},[275,1531,1532],{"class":277,"line":278},[275,1533,282],{"class":281},[275,1535,1536,1538,1541,1543,1545],{"class":277,"line":285},[275,1537,307],{"class":281},[275,1539,1540],{"class":291},"status",[275,1542,295],{"class":281},[275,1544,298],{"class":281},[275,1546,1547],{"class":281}," true,\n",[275,1549,1550,1552,1555,1557,1559],{"class":277,"line":304},[275,1551,307],{"class":281},[275,1553,1554],{"class":291},"result",[275,1556,295],{"class":281},[275,1558,298],{"class":281},[275,1560,301],{"class":281},[275,1562,1563,1565,1568,1570,1572,1574,1577,1579],{"class":277,"line":331},[275,1564,700],{"class":281},[275,1566,1567],{"class":310},"id",[275,1569,295],{"class":281},[275,1571,298],{"class":281},[275,1573,318],{"class":281},[275,1575,1576],{"class":321},"pre_Wt5RmK2xPqLv9nYcE7aBz",[275,1578,295],{"class":281},[275,1580,430],{"class":281},[275,1582,1583,1585,1587,1589,1591,1593,1595,1597],{"class":277,"line":337},[275,1584,700],{"class":281},[275,1586,244],{"class":310},[275,1588,295],{"class":281},[275,1590,298],{"class":281},[275,1592,318],{"class":281},[275,1594,257],{"class":321},[275,1596,295],{"class":281},[275,1598,430],{"class":281},[275,1600,1601,1603,1605,1607,1609,1611,1613,1615],{"class":277,"line":359},[275,1602,700],{"class":281},[275,1604,311],{"class":310},[275,1606,295],{"class":281},[275,1608,298],{"class":281},[275,1610,318],{"class":281},[275,1612,322],{"class":321},[275,1614,295],{"class":281},[275,1616,430],{"class":281},[275,1618,1619,1621,1623,1625,1627,1629,1631,1633],{"class":277,"line":453},[275,1620,700],{"class":281},[275,1622,557],{"class":310},[275,1624,295],{"class":281},[275,1626,298],{"class":281},[275,1628,318],{"class":281},[275,1630,566],{"class":321},[275,1632,295],{"class":281},[275,1634,430],{"class":281},[275,1636,1637,1639,1641,1643,1645,1647,1649,1651],{"class":277,"line":576},[275,1638,700],{"class":281},[275,1640,342],{"class":310},[275,1642,295],{"class":281},[275,1644,298],{"class":281},[275,1646,318],{"class":281},[275,1648,351],{"class":321},[275,1650,295],{"class":281},[275,1652,430],{"class":281},[275,1654,1655,1657,1660,1662,1664,1666,1669,1671],{"class":277,"line":583},[275,1656,700],{"class":281},[275,1658,1659],{"class":310},"pre_auth_status",[275,1661,295],{"class":281},[275,1663,298],{"class":281},[275,1665,318],{"class":281},[275,1667,1668],{"class":321},"AUTHORISED",[275,1670,295],{"class":281},[275,1672,430],{"class":281},[275,1674,1675,1677,1679,1681,1683,1685,1687,1689],{"class":277,"line":604},[275,1676,700],{"class":281},[275,1678,165],{"class":310},[275,1680,295],{"class":281},[275,1682,298],{"class":281},[275,1684,318],{"class":281},[275,1686,895],{"class":321},[275,1688,295],{"class":281},[275,1690,430],{"class":281},[275,1692,1693,1695,1697,1699,1701,1703,1706,1708],{"class":277,"line":609},[275,1694,700],{"class":281},[275,1696,179],{"class":310},[275,1698,295],{"class":281},[275,1700,298],{"class":281},[275,1702,318],{"class":281},[275,1704,1705],{"class":321},"tra_pr6CvR_4pvWwmgQ4y3dtY",[275,1707,295],{"class":281},[275,1709,430],{"class":281},[275,1711,1712,1714,1716,1718,1720],{"class":277,"line":630},[275,1713,700],{"class":281},[275,1715,1511],{"class":310},[275,1717,295],{"class":281},[275,1719,298],{"class":281},[275,1721,688],{"class":281},[275,1723,1724],{"class":277,"line":635},[275,1725,1726],{"class":281},"        {\n",[275,1728,1729,1732,1735,1737,1739,1742],{"class":277,"line":659},[275,1730,1731],{"class":281},"          \"",[275,1733,1734],{"class":621},"sequence",[275,1736,295],{"class":281},[275,1738,298],{"class":281},[275,1740,1741],{"class":621}," 1",[275,1743,430],{"class":281},[275,1745,1746,1748,1750,1752,1754,1756,1758,1760],{"class":277,"line":664},[275,1747,1731],{"class":281},[275,1749,165],{"class":621},[275,1751,295],{"class":281},[275,1753,298],{"class":281},[275,1755,318],{"class":281},[275,1757,445],{"class":321},[275,1759,295],{"class":281},[275,1761,430],{"class":281},[275,1763,1764,1766,1769,1771,1773],{"class":277,"line":670},[275,1765,1731],{"class":281},[275,1767,1768],{"class":621},"is_default",[275,1770,295],{"class":281},[275,1772,298],{"class":281},[275,1774,1547],{"class":281},[275,1776,1777,1779,1781,1783,1785,1787,1790,1792],{"class":277,"line":676},[275,1778,1731],{"class":281},[275,1780,179],{"class":621},[275,1782,295],{"class":281},[275,1784,298],{"class":281},[275,1786,318],{"class":281},[275,1788,1789],{"class":321},"tra_x9YtRw2QpLmN8vKcE3aBz",[275,1791,295],{"class":281},[275,1793,430],{"class":281},[275,1795,1796,1798,1801,1803,1805,1807,1810,1812],{"class":277,"line":691},[275,1797,1731],{"class":281},[275,1799,1800],{"class":621},"transaction_status",[275,1802,295],{"class":281},[275,1804,298],{"class":281},[275,1806,318],{"class":281},[275,1808,1809],{"class":321},"DECLINED",[275,1811,295],{"class":281},[275,1813,430],{"class":281},[275,1815,1816,1818,1821,1823,1825],{"class":277,"line":697},[275,1817,1731],{"class":281},[275,1819,1820],{"class":621},"error",[275,1822,295],{"class":281},[275,1824,298],{"class":281},[275,1826,301],{"class":281},[275,1828,1829,1832,1835,1837,1839,1841,1844,1846],{"class":277,"line":719},[275,1830,1831],{"class":281},"            \"",[275,1833,163],{"class":1834},"swJcz",[275,1836,295],{"class":281},[275,1838,298],{"class":281},[275,1840,318],{"class":281},[275,1842,1843],{"class":321},"INSUFFICIENT_FUNDS",[275,1845,295],{"class":281},[275,1847,430],{"class":281},[275,1849,1850,1852,1855,1857,1859,1861,1864],{"class":277,"line":737},[275,1851,1831],{"class":281},[275,1853,1854],{"class":1834},"message",[275,1856,295],{"class":281},[275,1858,298],{"class":281},[275,1860,318],{"class":281},[275,1862,1863],{"class":321},"The transaction was declined due to insufficient funds",[275,1865,407],{"class":281},[275,1867,1868],{"class":277,"line":743},[275,1869,1870],{"class":281},"          }\n",[275,1872,1873],{"class":277,"line":748},[275,1874,1875],{"class":281},"        },\n",[275,1877,1878],{"class":277,"line":768},[275,1879,1726],{"class":281},[275,1881,1882,1884,1886,1888,1890,1892],{"class":277,"line":786},[275,1883,1731],{"class":281},[275,1885,1734],{"class":621},[275,1887,295],{"class":281},[275,1889,298],{"class":281},[275,1891,731],{"class":621},[275,1893,430],{"class":281},[275,1895,1896,1898,1900,1902,1904,1906,1908,1910],{"class":277,"line":792},[275,1897,1731],{"class":281},[275,1899,165],{"class":621},[275,1901,295],{"class":281},[275,1903,298],{"class":281},[275,1905,318],{"class":281},[275,1907,895],{"class":321},[275,1909,295],{"class":281},[275,1911,430],{"class":281},[275,1913,1914,1916,1918,1920,1922],{"class":277,"line":798},[275,1915,1731],{"class":281},[275,1917,1768],{"class":621},[275,1919,295],{"class":281},[275,1921,298],{"class":281},[275,1923,1924],{"class":281}," false,\n",[275,1926,1927,1929,1931,1933,1935,1937,1939,1941],{"class":277,"line":803},[275,1928,1731],{"class":281},[275,1930,179],{"class":621},[275,1932,295],{"class":281},[275,1934,298],{"class":281},[275,1936,318],{"class":281},[275,1938,1705],{"class":321},[275,1940,295],{"class":281},[275,1942,430],{"class":281},[275,1944,1945,1947,1949,1951,1953,1955,1957],{"class":277,"line":809},[275,1946,1731],{"class":281},[275,1948,1800],{"class":621},[275,1950,295],{"class":281},[275,1952,298],{"class":281},[275,1954,318],{"class":281},[275,1956,1668],{"class":321},[275,1958,407],{"class":281},[275,1960,1961],{"class":277,"line":823},[275,1962,1963],{"class":281},"        }\n",[275,1965,1966],{"class":277,"line":841},[275,1967,1968],{"class":281},"      ],\n",[275,1970,1971,1973,1975,1977,1979,1981,1984,1986],{"class":277,"line":861},[275,1972,700],{"class":281},[275,1974,197],{"class":310},[275,1976,295],{"class":281},[275,1978,298],{"class":281},[275,1980,318],{"class":281},[275,1982,1983],{"class":321},"2026-07-13T10:15:30Z",[275,1985,295],{"class":281},[275,1987,430],{"class":281},[275,1989,1990,1992,1995,1997,1999,2001,2004],{"class":277,"line":879},[275,1991,700],{"class":281},[275,1993,1994],{"class":310},"created_at",[275,1996,295],{"class":281},[275,1998,298],{"class":281},[275,2000,318],{"class":281},[275,2002,2003],{"class":321},"2026-07-06T10:15:30Z",[275,2005,407],{"class":281},[275,2007,2008],{"class":277,"line":890},[275,2009,789],{"class":281},[275,2011,2012],{"class":277,"line":900},[275,2013,362],{"class":281},[159,2015,2016],{},"Example where all cards declined:",[266,2018,2020],{"className":268,"code":2019,"language":270,"meta":271,"style":271},"{\n    \"status\": false,\n    \"result\": {\n      \"id\": \"pre_Rk8NwT4yQmXz2pLvE9aBc\",\n      \"customer_id\": \"cus_abc123...\",\n      \"amount\": \"349.00\",\n      \"currency\": \"ZAR\",\n      \"reference\": \"INV-2026-00042\",\n      \"pre_auth_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",[163,2021,2022,2026,2038,2050,2069,2087,2105,2123,2141,2160,2173,2185,2197,2201,2215,2233,2245,2263,2281,2293,2311,2327,2331,2335,2339,2353,2371,2383,2402,2420,2432,2451,2468,2472,2476,2480,2497,2501],{"__ignoreMap":271},[275,2023,2024],{"class":277,"line":278},[275,2025,282],{"class":281},[275,2027,2028,2030,2032,2034,2036],{"class":277,"line":285},[275,2029,307],{"class":281},[275,2031,1540],{"class":291},[275,2033,295],{"class":281},[275,2035,298],{"class":281},[275,2037,1924],{"class":281},[275,2039,2040,2042,2044,2046,2048],{"class":277,"line":304},[275,2041,307],{"class":281},[275,2043,1554],{"class":291},[275,2045,295],{"class":281},[275,2047,298],{"class":281},[275,2049,301],{"class":281},[275,2051,2052,2054,2056,2058,2060,2062,2065,2067],{"class":277,"line":331},[275,2053,700],{"class":281},[275,2055,1567],{"class":310},[275,2057,295],{"class":281},[275,2059,298],{"class":281},[275,2061,318],{"class":281},[275,2063,2064],{"class":321},"pre_Rk8NwT4yQmXz2pLvE9aBc",[275,2066,295],{"class":281},[275,2068,430],{"class":281},[275,2070,2071,2073,2075,2077,2079,2081,2083,2085],{"class":277,"line":337},[275,2072,700],{"class":281},[275,2074,244],{"class":310},[275,2076,295],{"class":281},[275,2078,298],{"class":281},[275,2080,318],{"class":281},[275,2082,257],{"class":321},[275,2084,295],{"class":281},[275,2086,430],{"class":281},[275,2088,2089,2091,2093,2095,2097,2099,2101,2103],{"class":277,"line":359},[275,2090,700],{"class":281},[275,2092,311],{"class":310},[275,2094,295],{"class":281},[275,2096,298],{"class":281},[275,2098,318],{"class":281},[275,2100,322],{"class":321},[275,2102,295],{"class":281},[275,2104,430],{"class":281},[275,2106,2107,2109,2111,2113,2115,2117,2119,2121],{"class":277,"line":453},[275,2108,700],{"class":281},[275,2110,557],{"class":310},[275,2112,295],{"class":281},[275,2114,298],{"class":281},[275,2116,318],{"class":281},[275,2118,566],{"class":321},[275,2120,295],{"class":281},[275,2122,430],{"class":281},[275,2124,2125,2127,2129,2131,2133,2135,2137,2139],{"class":277,"line":576},[275,2126,700],{"class":281},[275,2128,342],{"class":310},[275,2130,295],{"class":281},[275,2132,298],{"class":281},[275,2134,318],{"class":281},[275,2136,351],{"class":321},[275,2138,295],{"class":281},[275,2140,430],{"class":281},[275,2142,2143,2145,2147,2149,2151,2153,2156,2158],{"class":277,"line":583},[275,2144,700],{"class":281},[275,2146,1659],{"class":310},[275,2148,295],{"class":281},[275,2150,298],{"class":281},[275,2152,318],{"class":281},[275,2154,2155],{"class":321},"FAILED",[275,2157,295],{"class":281},[275,2159,430],{"class":281},[275,2161,2162,2164,2166,2168,2170],{"class":277,"line":604},[275,2163,700],{"class":281},[275,2165,165],{"class":310},[275,2167,295],{"class":281},[275,2169,298],{"class":281},[275,2171,2172],{"class":281}," null,\n",[275,2174,2175,2177,2179,2181,2183],{"class":277,"line":609},[275,2176,700],{"class":281},[275,2178,179],{"class":310},[275,2180,295],{"class":281},[275,2182,298],{"class":281},[275,2184,2172],{"class":281},[275,2186,2187,2189,2191,2193,2195],{"class":277,"line":630},[275,2188,700],{"class":281},[275,2190,1511],{"class":310},[275,2192,295],{"class":281},[275,2194,298],{"class":281},[275,2196,688],{"class":281},[275,2198,2199],{"class":277,"line":635},[275,2200,1726],{"class":281},[275,2202,2203,2205,2207,2209,2211,2213],{"class":277,"line":659},[275,2204,1731],{"class":281},[275,2206,1734],{"class":621},[275,2208,295],{"class":281},[275,2210,298],{"class":281},[275,2212,1741],{"class":621},[275,2214,430],{"class":281},[275,2216,2217,2219,2221,2223,2225,2227,2229,2231],{"class":277,"line":664},[275,2218,1731],{"class":281},[275,2220,165],{"class":621},[275,2222,295],{"class":281},[275,2224,298],{"class":281},[275,2226,318],{"class":281},[275,2228,445],{"class":321},[275,2230,295],{"class":281},[275,2232,430],{"class":281},[275,2234,2235,2237,2239,2241,2243],{"class":277,"line":670},[275,2236,1731],{"class":281},[275,2238,1768],{"class":621},[275,2240,295],{"class":281},[275,2242,298],{"class":281},[275,2244,1547],{"class":281},[275,2246,2247,2249,2251,2253,2255,2257,2259,2261],{"class":277,"line":676},[275,2248,1731],{"class":281},[275,2250,179],{"class":621},[275,2252,295],{"class":281},[275,2254,298],{"class":281},[275,2256,318],{"class":281},[275,2258,1789],{"class":321},[275,2260,295],{"class":281},[275,2262,430],{"class":281},[275,2264,2265,2267,2269,2271,2273,2275,2277,2279],{"class":277,"line":691},[275,2266,1731],{"class":281},[275,2268,1800],{"class":621},[275,2270,295],{"class":281},[275,2272,298],{"class":281},[275,2274,318],{"class":281},[275,2276,1809],{"class":321},[275,2278,295],{"class":281},[275,2280,430],{"class":281},[275,2282,2283,2285,2287,2289,2291],{"class":277,"line":697},[275,2284,1731],{"class":281},[275,2286,1820],{"class":621},[275,2288,295],{"class":281},[275,2290,298],{"class":281},[275,2292,301],{"class":281},[275,2294,2295,2297,2299,2301,2303,2305,2307,2309],{"class":277,"line":719},[275,2296,1831],{"class":281},[275,2298,163],{"class":1834},[275,2300,295],{"class":281},[275,2302,298],{"class":281},[275,2304,318],{"class":281},[275,2306,1843],{"class":321},[275,2308,295],{"class":281},[275,2310,430],{"class":281},[275,2312,2313,2315,2317,2319,2321,2323,2325],{"class":277,"line":737},[275,2314,1831],{"class":281},[275,2316,1854],{"class":1834},[275,2318,295],{"class":281},[275,2320,298],{"class":281},[275,2322,318],{"class":281},[275,2324,1863],{"class":321},[275,2326,407],{"class":281},[275,2328,2329],{"class":277,"line":743},[275,2330,1870],{"class":281},[275,2332,2333],{"class":277,"line":748},[275,2334,1875],{"class":281},[275,2336,2337],{"class":277,"line":768},[275,2338,1726],{"class":281},[275,2340,2341,2343,2345,2347,2349,2351],{"class":277,"line":786},[275,2342,1731],{"class":281},[275,2344,1734],{"class":621},[275,2346,295],{"class":281},[275,2348,298],{"class":281},[275,2350,731],{"class":621},[275,2352,430],{"class":281},[275,2354,2355,2357,2359,2361,2363,2365,2367,2369],{"class":277,"line":792},[275,2356,1731],{"class":281},[275,2358,165],{"class":621},[275,2360,295],{"class":281},[275,2362,298],{"class":281},[275,2364,318],{"class":281},[275,2366,895],{"class":321},[275,2368,295],{"class":281},[275,2370,430],{"class":281},[275,2372,2373,2375,2377,2379,2381],{"class":277,"line":798},[275,2374,1731],{"class":281},[275,2376,1768],{"class":621},[275,2378,295],{"class":281},[275,2380,298],{"class":281},[275,2382,1924],{"class":281},[275,2384,2385,2387,2389,2391,2393,2395,2398,2400],{"class":277,"line":803},[275,2386,1731],{"class":281},[275,2388,179],{"class":621},[275,2390,295],{"class":281},[275,2392,298],{"class":281},[275,2394,318],{"class":281},[275,2396,2397],{"class":321},"tra_z2QpLvE9aBcRk8NwT4yQm",[275,2399,295],{"class":281},[275,2401,430],{"class":281},[275,2403,2404,2406,2408,2410,2412,2414,2416,2418],{"class":277,"line":809},[275,2405,1731],{"class":281},[275,2407,1800],{"class":621},[275,2409,295],{"class":281},[275,2411,298],{"class":281},[275,2413,318],{"class":281},[275,2415,1809],{"class":321},[275,2417,295],{"class":281},[275,2419,430],{"class":281},[275,2421,2422,2424,2426,2428,2430],{"class":277,"line":823},[275,2423,1731],{"class":281},[275,2425,1820],{"class":621},[275,2427,295],{"class":281},[275,2429,298],{"class":281},[275,2431,301],{"class":281},[275,2433,2434,2436,2438,2440,2442,2444,2447,2449],{"class":277,"line":841},[275,2435,1831],{"class":281},[275,2437,163],{"class":1834},[275,2439,295],{"class":281},[275,2441,298],{"class":281},[275,2443,318],{"class":281},[275,2445,2446],{"class":321},"EXPIRED_CARD",[275,2448,295],{"class":281},[275,2450,430],{"class":281},[275,2452,2453,2455,2457,2459,2461,2463,2466],{"class":277,"line":861},[275,2454,1831],{"class":281},[275,2456,1854],{"class":1834},[275,2458,295],{"class":281},[275,2460,298],{"class":281},[275,2462,318],{"class":281},[275,2464,2465],{"class":321},"The transaction was declined because the card has expired",[275,2467,407],{"class":281},[275,2469,2470],{"class":277,"line":879},[275,2471,1870],{"class":281},[275,2473,2474],{"class":277,"line":890},[275,2475,1963],{"class":281},[275,2477,2478],{"class":277,"line":900},[275,2479,1968],{"class":281},[275,2481,2482,2484,2486,2488,2490,2492,2495],{"class":277,"line":906},[275,2483,700],{"class":281},[275,2485,1994],{"class":310},[275,2487,295],{"class":281},[275,2489,298],{"class":281},[275,2491,318],{"class":281},[275,2493,2494],{"class":321},"2026-07-06T10:15:35Z",[275,2496,407],{"class":281},[275,2498,2499],{"class":277,"line":933},[275,2500,789],{"class":281},[275,2502,2503],{"class":277,"line":938},[275,2504,362],{"class":281},[200,2506,2508],{"id":2507},"response-parameters","Response Parameters",[214,2510,2511,2527],{},[217,2512,2513],{},[220,2514,2515,2519,2521,2525],{},[223,2516,2517],{"align":225},[1088,2518,1091],{"style":1090},[223,2520,229],{"align":225},[223,2522,2523],{"align":225},[1088,2524,232],{"style":1101},[223,2526,235],{"align":225},[237,2528,2529,2540,2552,2564,2576,2593,2605,2637,2653,2667,2682,2696,2710,2724,2738,2756,2774,2788,2800],{},[220,2530,2531,2533,2535,2538],{},[242,2532,1540],{"align":225},[242,2534,1353],{"align":225},[242,2536,2537],{"align":225},"Whether the pre-auth succeeded",[242,2539,1363],{"align":225},[220,2541,2542,2545,2547,2550],{},[242,2543,2544],{"align":225},"result.id",[242,2546,247],{"align":225},[242,2548,2549],{"align":225},"Unique pre-auth identifier wrapping all cascade attempts",[242,2551,1576],{"align":225},[220,2553,2554,2557,2559,2562],{},[242,2555,2556],{"align":225},"result.customer_id",[242,2558,247],{"align":225},[242,2560,2561],{"align":225},"Associated customer ID",[242,2563,257],{"align":225},[220,2565,2566,2569,2571,2574],{},[242,2567,2568],{"align":225},"result.amount",[242,2570,1130],{"align":225},[242,2572,2573],{"align":225},"Amount placed on hold",[242,2575,322],{"align":225},[220,2577,2578,2581,2583,2589],{},[242,2579,2580],{"align":225},"result.currency",[242,2582,1180],{"align":225},[242,2584,2585,2588],{"align":225},[171,2586,1189],{"href":1185,"rel":2587,":target":1188},[1187]," currency code",[242,2590,2591],{"align":225},[163,2592,566],{},[220,2594,2595,2598,2600,2603],{},[242,2596,2597],{"align":225},"result.reference",[242,2599,1205],{"align":225},[242,2601,2602],{"align":225},"Your reference for this pre-auth",[242,2604,351],{"align":225},[220,2606,2607,2610,2613,2633],{},[242,2608,2609],{"align":225},"result.pre_auth_status",[242,2611,2612],{"align":225},"ENUM",[242,2614,2615,2616,1415,2618,1415,2620,1415,2623,2626,2627,2630,2631],{"align":225},"Overall pre-auth state: ",[163,2617,1668],{},[163,2619,2155],{},[163,2621,2622],{},"CAPTURED",[163,2624,2625],{},"REVERSED",", or ",[163,2628,2629],{},"EXPIRED",", see ",[171,2632,1426],{"href":1425},[242,2634,2635],{"align":225},[163,2636,1668],{},[220,2638,2639,2642,2644,2651],{},[242,2640,2641],{"align":225},"result.card_id",[242,2643,247],{"align":225},[242,2645,2646,2647,2650],{"align":225},"The card that was ultimately authorised; ",[163,2648,2649],{},"null"," when the pre-auth failed",[242,2652,895],{"align":225},[220,2654,2655,2658,2660,2665],{},[242,2656,2657],{"align":225},"result.transaction_id",[242,2659,247],{"align":225},[242,2661,2662,2663,2650],{"align":225},"The authorised transaction — pass this to the capture and reverse endpoints; ",[163,2664,2649],{},[242,2666,1705],{"align":225},[220,2668,2669,2672,2674,2677],{},[242,2670,2671],{"align":225},"result.attempts",[242,2673,1257],{"align":225},[242,2675,2676],{"align":225},"Every card attempt in the order tried, including declines",[242,2678,2679],{"align":225},[275,2680,2681],{},"...",[220,2683,2684,2689,2691,2694],{},[242,2685,2671,2686,2688],{"align":225},[275,2687],{},".sequence",[242,2690,1232],{"align":225},[242,2692,2693],{"align":225},"Position of this attempt in the cascade",[242,2695,1238],{"align":225},[220,2697,2698,2703,2705,2708],{},[242,2699,2671,2700,2702],{"align":225},[275,2701],{},".card_id",[242,2704,247],{"align":225},[242,2706,2707],{"align":225},"Card attempted",[242,2709,445],{"align":225},[220,2711,2712,2717,2719,2722],{},[242,2713,2671,2714,2716],{"align":225},[275,2715],{},".is_default",[242,2718,1353],{"align":225},[242,2720,2721],{"align":225},"Whether this card was the customer's default at the time of the pre-auth",[242,2723,1363],{"align":225},[220,2725,2726,2731,2733,2736],{},[242,2727,2671,2728,2730],{"align":225},[275,2729],{},".transaction_id",[242,2732,247],{"align":225},[242,2734,2735],{"align":225},"Transaction identifier for this attempt",[242,2737,1789],{"align":225},[220,2739,2740,2745,2747,2752],{},[242,2741,2671,2742,2744],{"align":225},[275,2743],{},".transaction_status",[242,2746,2612],{"align":225},[242,2748,2749,2750],{"align":225},"Transaction status, see ",[171,2751,1426],{"href":1425},[242,2753,2754],{"align":225},[163,2755,1809],{},[220,2757,2758,2763,2765,2770],{},[242,2759,2671,2760,2762],{"align":225},[275,2761],{},".error.code",[242,2764,2612],{"align":225},[242,2766,2767,2768],{"align":225},"Decline code when the attempt failed, see ",[171,2769,1426],{"href":1425},[242,2771,2772],{"align":225},[163,2773,1843],{},[220,2775,2776,2781,2783,2786],{},[242,2777,2671,2778,2780],{"align":225},[275,2779],{},".error.message",[242,2782,1130],{"align":225},[242,2784,2785],{"align":225},"Human-readable decline reason",[242,2787,1863],{"align":225},[220,2789,2790,2793,2795,2798],{},[242,2791,2792],{"align":225},"result.expires_at",[242,2794,1130],{"align":225},[242,2796,2797],{"align":225},"ISO timestamp when the uncaptured hold is automatically released",[242,2799,1983],{"align":225},[220,2801,2802,2805,2807,2810],{},[242,2803,2804],{"align":225},"result.created_at",[242,2806,1130],{"align":225},[242,2808,2809],{"align":225},"ISO timestamp when the pre-auth was created",[242,2811,2003],{"align":225},[154,2813,2815],{"id":2814},"capture-request","Capture Request",[159,2817,2818,2819,2821,2822,2826,2827,2829,2830,2832],{},"Capture (settle) a previously authorised hold by passing the ",[163,2820,179],{}," returned by the ",[171,2823,2825],{"href":2824},"#pre-auth-request","pre-auth request",". The full held amount is captured by default; pass ",[163,2828,311],{}," for a partial capture — any remaining held funds are automatically released. A pre-auth can be captured once, and only while its status is ",[163,2831,1668],{},".",[200,2834,203],{"id":2835},"path-1",[159,2837,2838,209,2840],{},[163,2839,208],{},[163,2841,2842],{},"\u002Fcard-vault\u002Fpre-auth\u002F{transaction_id}\u002Fcapture",[214,2844,2845,2857],{},[217,2846,2847],{},[220,2848,2849,2851,2853,2855],{},[223,2850,226],{"align":225},[223,2852,229],{"align":225},[223,2854,232],{"align":225},[223,2856,235],{"align":225},[237,2858,2859],{},[220,2860,2861,2863,2865,2868],{},[242,2862,179],{"align":225},[242,2864,247],{"align":225},[242,2866,2867],{"align":225},"The authorised transaction returned by the pre-auth request",[242,2869,1705],{"align":225},[200,2871,2873],{"id":2872},"example-full-capture","Example (Full capture)",[159,2875,2876,2877,2880],{},"Capture the full held amount. An empty body (or ",[163,2878,2879],{},"{}",") is valid.",[266,2882,2884],{"className":268,"code":2883,"language":270,"meta":271,"style":271},"{\n  \"reference\": \"INV-2026-00042-CAP\" \u002F\u002F [optional] defaults to the pre-auth reference\n}\n",[163,2885,2886,2890,2910],{"__ignoreMap":271},[275,2887,2888],{"class":277,"line":278},[275,2889,282],{"class":281},[275,2891,2892,2894,2896,2898,2900,2902,2905,2907],{"class":277,"line":285},[275,2893,288],{"class":281},[275,2895,342],{"class":291},[275,2897,295],{"class":281},[275,2899,298],{"class":281},[275,2901,318],{"class":281},[275,2903,2904],{"class":321},"INV-2026-00042-CAP",[275,2906,295],{"class":281},[275,2908,2909],{"class":327}," \u002F\u002F [optional] defaults to the pre-auth reference\n",[275,2911,2912],{"class":277,"line":304},[275,2913,362],{"class":281},[200,2915,2917],{"id":2916},"example-partial-capture-with-invoice","Example (Partial capture with invoice)",[159,2919,2920],{},"Capture part of the hold; the remainder is released back to the cardholder.",[159,2922,2923,2924,2926,2927,2929,2930,2932,2933,2937,2938,2942,2943,2945,2946,189,2948,2950,2951,2832],{},"When generating an invoice, the line items default to the ",[163,2925,292],{}," \u002F ",[163,2928,681],{}," supplied on the ",[171,2931,2825],{"href":2824},". Pass a single ",[1071,2934,2935],{},[163,2936,292],{}," object or an ",[1071,2939,2940],{},[163,2941,681],{}," array here to override them — see ",[171,2944,87],{"href":88}," for the same pattern. Overriding is recommended on partial captures so the invoice lines match the captured amount. When no ",[163,2947,1140],{},[163,2949,681],{}," were supplied on either call, the invoice shows a single line using the pre-auth ",[163,2952,342],{},[266,2954,2956],{"className":268,"code":2955,"language":270,"meta":271,"style":271},"{\n  \"amount\": \"299.00\", \u002F\u002F [optional] must be \u003C= the held amount; omit to capture in full\n  \"reference\": \"INV-2026-00042-CAP\", \u002F\u002F [optional] defaults to the pre-auth reference\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 Invoice line items — overrides the item \u002F items supplied on the pre-auth;\n  \u002F\u002F pass item for a single free-form line, or items for catalog lines (mutually exclusive)\n  \"items\": [\n    {\n      \"product_id\": \"pro_abc123...\",\n      \"qty\": 2 \u002F\u002F default 1 when omitted\n    },\n    {\n      \"product_id\": \"pro_xyz789...\",\n      \"price_excl\": 300.23 \u002F\u002F override the default product amount\n    }\n  ],\n\n  \u002F\u002F Issue and optionally email an invoice for the captured amount\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 capture outcome\n    \"webhook_url\": \"https:\u002F\u002Fmerchant.example\u002Fwebhooks\u002Fpayments\" \u002F\u002F [optional] overrides the webhook URL supplied on the pre-auth\n  }\n}\n",[163,2957,2958,2962,2984,3004,3008,3028,3032,3037,3042,3054,3058,3076,3090,3094,3098,3116,3130,3134,3138,3142,3147,3160,3173,3190,3194,3198,3210,3231,3250,3254],{"__ignoreMap":271},[275,2959,2960],{"class":277,"line":278},[275,2961,282],{"class":281},[275,2963,2964,2966,2968,2970,2972,2974,2977,2979,2981],{"class":277,"line":285},[275,2965,288],{"class":281},[275,2967,311],{"class":291},[275,2969,295],{"class":281},[275,2971,298],{"class":281},[275,2973,318],{"class":281},[275,2975,2976],{"class":321},"299.00",[275,2978,295],{"class":281},[275,2980,522],{"class":281},[275,2982,2983],{"class":327}," \u002F\u002F [optional] must be \u003C= the held amount; omit to capture in full\n",[275,2985,2986,2988,2990,2992,2994,2996,2998,3000,3002],{"class":277,"line":304},[275,2987,288],{"class":281},[275,2989,342],{"class":291},[275,2991,295],{"class":281},[275,2993,298],{"class":281},[275,2995,318],{"class":281},[275,2997,2904],{"class":321},[275,2999,295],{"class":281},[275,3001,522],{"class":281},[275,3003,2909],{"class":327},[275,3005,3006],{"class":277,"line":331},[275,3007,580],{"emptyLinePlaceholder":579},[275,3009,3010,3012,3014,3016,3018,3020,3022,3024,3026],{"class":277,"line":337},[275,3011,288],{"class":281},[275,3013,640],{"class":291},[275,3015,295],{"class":281},[275,3017,298],{"class":281},[275,3019,318],{"class":281},[275,3021,649],{"class":321},[275,3023,295],{"class":281},[275,3025,522],{"class":281},[275,3027,656],{"class":327},[275,3029,3030],{"class":277,"line":359},[275,3031,580],{"emptyLinePlaceholder":579},[275,3033,3034],{"class":277,"line":453},[275,3035,3036],{"class":327},"  \u002F\u002F Invoice line items — overrides the item \u002F items supplied on the pre-auth;\n",[275,3038,3039],{"class":277,"line":576},[275,3040,3041],{"class":327},"  \u002F\u002F pass item for a single free-form line, or items for catalog lines (mutually exclusive)\n",[275,3043,3044,3046,3048,3050,3052],{"class":277,"line":583},[275,3045,288],{"class":281},[275,3047,681],{"class":291},[275,3049,295],{"class":281},[275,3051,298],{"class":281},[275,3053,688],{"class":281},[275,3055,3056],{"class":277,"line":604},[275,3057,694],{"class":281},[275,3059,3060,3062,3064,3066,3068,3070,3072,3074],{"class":277,"line":609},[275,3061,700],{"class":281},[275,3063,703],{"class":310},[275,3065,295],{"class":281},[275,3067,298],{"class":281},[275,3069,318],{"class":281},[275,3071,712],{"class":321},[275,3073,295],{"class":281},[275,3075,430],{"class":281},[275,3077,3078,3080,3082,3084,3086,3088],{"class":277,"line":630},[275,3079,700],{"class":281},[275,3081,724],{"class":310},[275,3083,295],{"class":281},[275,3085,298],{"class":281},[275,3087,731],{"class":621},[275,3089,734],{"class":327},[275,3091,3092],{"class":277,"line":635},[275,3093,740],{"class":281},[275,3095,3096],{"class":277,"line":659},[275,3097,694],{"class":281},[275,3099,3100,3102,3104,3106,3108,3110,3112,3114],{"class":277,"line":664},[275,3101,700],{"class":281},[275,3103,703],{"class":310},[275,3105,295],{"class":281},[275,3107,298],{"class":281},[275,3109,318],{"class":281},[275,3111,761],{"class":321},[275,3113,295],{"class":281},[275,3115,430],{"class":281},[275,3117,3118,3120,3122,3124,3126,3128],{"class":277,"line":670},[275,3119,700],{"class":281},[275,3121,773],{"class":310},[275,3123,295],{"class":281},[275,3125,298],{"class":281},[275,3127,780],{"class":621},[275,3129,783],{"class":327},[275,3131,3132],{"class":277,"line":676},[275,3133,789],{"class":281},[275,3135,3136],{"class":277,"line":691},[275,3137,795],{"class":281},[275,3139,3140],{"class":277,"line":697},[275,3141,580],{"emptyLinePlaceholder":579},[275,3143,3144],{"class":277,"line":719},[275,3145,3146],{"class":327},"  \u002F\u002F Issue and optionally email an invoice for the captured amount\n",[275,3148,3149,3151,3154,3156,3158],{"class":277,"line":737},[275,3150,288],{"class":281},[275,3152,3153],{"class":291},"invoice",[275,3155,295],{"class":281},[275,3157,298],{"class":281},[275,3159,301],{"class":281},[275,3161,3162,3164,3167,3169,3171],{"class":277,"line":743},[275,3163,307],{"class":281},[275,3165,3166],{"class":310},"is_generate",[275,3168,295],{"class":281},[275,3170,298],{"class":281},[275,3172,1547],{"class":281},[275,3174,3175,3177,3180,3182,3184,3187],{"class":277,"line":748},[275,3176,307],{"class":281},[275,3178,3179],{"class":310},"is_send",[275,3181,295],{"class":281},[275,3183,298],{"class":281},[275,3185,3186],{"class":281}," true",[275,3188,3189],{"class":327}," \u002F\u002F send paid invoice to the customer when true\n",[275,3191,3192],{"class":277,"line":768},[275,3193,334],{"class":281},[275,3195,3196],{"class":277,"line":786},[275,3197,580],{"emptyLinePlaceholder":579},[275,3199,3200,3202,3204,3206,3208],{"class":277,"line":792},[275,3201,288],{"class":281},[275,3203,948],{"class":291},[275,3205,295],{"class":281},[275,3207,298],{"class":281},[275,3209,301],{"class":281},[275,3211,3212,3214,3216,3218,3220,3222,3224,3226,3228],{"class":277,"line":798},[275,3213,307],{"class":281},[275,3215,962],{"class":310},[275,3217,295],{"class":281},[275,3219,298],{"class":281},[275,3221,318],{"class":281},[275,3223,971],{"class":321},[275,3225,295],{"class":281},[275,3227,522],{"class":281},[275,3229,3230],{"class":327}," \u002F\u002F [optional] email notification on the capture outcome\n",[275,3232,3233,3235,3237,3239,3241,3243,3245,3247],{"class":277,"line":803},[275,3234,307],{"class":281},[275,3236,986],{"class":310},[275,3238,295],{"class":281},[275,3240,298],{"class":281},[275,3242,318],{"class":281},[275,3244,995],{"class":321},[275,3246,295],{"class":281},[275,3248,3249],{"class":327}," \u002F\u002F [optional] overrides the webhook URL supplied on the pre-auth\n",[275,3251,3252],{"class":277,"line":809},[275,3253,1052],{"class":281},[275,3255,3256],{"class":277,"line":823},[275,3257,362],{"class":281},[200,3259,1061],{"id":3260},"request-parameters-1",[214,3262,3263,3281],{},[217,3264,3265],{},[220,3266,3267,3271,3273,3275,3279],{},[223,3268,3269],{"align":225},[1088,3270,1091],{"style":1090},[223,3272,1094],{"align":225},[223,3274,229],{"align":225},[223,3276,3277],{"align":225},[1088,3278,232],{"style":1101},[223,3280,235],{"align":225},[237,3282,3283,3296,3309,3327,3340,3352,3371,3385,3401,3415,3427,3441,3455,3470],{},[220,3284,3285,3287,3289,3291,3294],{},[242,3286,311],{"align":225},[242,3288,1143],{"align":225},[242,3290,1130],{"align":225},[242,3292,3293],{"align":225},"Amount to capture; must be less than or equal to the held amount. Omit to capture the full hold. Any uncaptured remainder is released",[242,3295,2976],{"align":225},[220,3297,3298,3300,3302,3304,3307],{},[242,3299,342],{"align":225},[242,3301,1143],{"align":225},[242,3303,1205],{"align":225},[242,3305,3306],{"align":225},"Your reference for the capture; defaults to the pre-auth reference",[242,3308,2904],{"align":225},[220,3310,3311,3313,3315,3317,3322],{},[242,3312,292],{"align":225},[242,3314,1143],{"align":225},[242,3316,1114],{"align":225},[242,3318,3319,3320],{"align":225},"Single free-form invoice line when generating an invoice; overrides the lines supplied on the pre-auth. Mutually exclusive with ",[163,3321,681],{},[242,3323,3324],{"align":225},[163,3325,3326],{},"{\"title\": \"Booking deposit\"}",[220,3328,3329,3331,3333,3335,3338],{},[242,3330,1140],{"align":225},[242,3332,1077],{"align":225},[242,3334,1130],{"align":225},[242,3336,3337],{"align":225},"Line item title shown on the invoice",[242,3339,517],{"align":225},[220,3341,3342,3344,3346,3348,3350],{},[242,3343,1162],{"align":225},[242,3345,1143],{"align":225},[242,3347,1130],{"align":225},[242,3349,1169],{"align":225},[242,3351,541],{"align":225},[220,3353,3354,3356,3358,3360,3368],{},[242,3355,681],{"align":225},[242,3357,1143],{"align":225},[242,3359,1257],{"align":225},[242,3361,3362,3363,3365,3366],{"align":225},"Invoice line items from your catalog when generating an invoice; overrides the lines supplied on the pre-auth. Mutually exclusive with ",[163,3364,292],{}," — see ",[171,3367,1270],{"href":1269},[242,3369,3370],{"align":225},"See partial capture example",[220,3372,3373,3377,3379,3381,3383],{},[242,3374,681,3375,1280],{"align":225},[275,3376],{},[242,3378,1073],{"align":225},[242,3380,1130],{"align":225},[242,3382,1287],{"align":225},[242,3384,712],{"align":225},[220,3386,3387,3391,3393,3395,3399],{},[242,3388,681,3389,1296],{"align":225},[275,3390],{},[242,3392,1143],{"align":225},[242,3394,1232],{"align":225},[242,3396,1303,3397,1306],{"align":225},[163,3398,1238],{},[242,3400,1309],{"align":225},[220,3402,3403,3407,3409,3411,3413],{},[242,3404,681,3405,1316],{"align":225},[275,3406],{},[242,3408,1143],{"align":225},[242,3410,1321],{"align":225},[242,3412,1324],{"align":225},[242,3414,1327],{"align":225},[220,3416,3417,3419,3421,3423,3425],{},[242,3418,640],{"align":225},[242,3420,1143],{"align":225},[242,3422,1130],{"align":225},[242,3424,1442],{"align":225},[242,3426,649],{"align":225},[220,3428,3429,3432,3434,3436,3439],{},[242,3430,3431],{"align":225},"invoice.is_generate",[242,3433,1143],{"align":225},[242,3435,1353],{"align":225},[242,3437,3438],{"align":225},"Whether to generate an invoice for the captured amount",[242,3440,1363],{"align":225},[220,3442,3443,3446,3448,3450,3453],{},[242,3444,3445],{"align":225},"invoice.is_send",[242,3447,1143],{"align":225},[242,3449,1353],{"align":225},[242,3451,3452],{"align":225},"Whether to send the paid invoice to the customer",[242,3454,1363],{"align":225},[220,3456,3457,3459,3461,3463,3466],{},[242,3458,1449],{"align":225},[242,3460,1143],{"align":225},[242,3462,1130],{"align":225},[242,3464,3465],{"align":225},"Email address to notify on the capture outcome",[242,3467,3468],{"align":225},[171,3469,971],{"href":1461},[220,3471,3472,3474,3476,3478,3481],{},[242,3473,1466],{"align":225},[242,3475,1143],{"align":225},[242,3477,1130],{"align":225},[242,3479,3480],{"align":225},"Webhook URL for the capture outcome; overrides the URL supplied on the pre-auth",[242,3482,3483],{"align":225},[171,3484,995],{"href":995,"rel":3485},[1187],[200,3487,1498],{"id":3488},"response-body-1",[266,3490,3492],{"className":268,"code":3491,"language":270,"meta":271,"style":271},"{\n    \"status\": true,\n    \"result\": {\n      \"id\": \"pre_Wt5RmK2xPqLv9nYcE7aBz\",\n      \"customer_id\": \"cus_abc123...\",\n      \"transaction_id\": \"tra_pr6CvR_4pvWwmgQ4y3dtY\",\n      \"card_id\": \"crd_9kLmXw3RtYqPz8vNcE2aB\",\n      \"pre_auth_status\": \"CAPTURED\",\n      \"amount\": \"349.00\",\n      \"captured_amount\": \"299.00\",\n      \"released_amount\": \"50.00\",\n      \"currency\": \"ZAR\",\n      \"reference\": \"INV-2026-00042-CAP\",\n      \"invoice_id\": \"inv_k2Jd8sLqPz...\",\n      \"captured_at\": \"2026-07-08T09:20:00Z\"\n    }\n}\n",[163,3493,3494,3498,3510,3522,3540,3558,3576,3594,3612,3630,3649,3669,3687,3705,3725,3743,3747],{"__ignoreMap":271},[275,3495,3496],{"class":277,"line":278},[275,3497,282],{"class":281},[275,3499,3500,3502,3504,3506,3508],{"class":277,"line":285},[275,3501,307],{"class":281},[275,3503,1540],{"class":291},[275,3505,295],{"class":281},[275,3507,298],{"class":281},[275,3509,1547],{"class":281},[275,3511,3512,3514,3516,3518,3520],{"class":277,"line":304},[275,3513,307],{"class":281},[275,3515,1554],{"class":291},[275,3517,295],{"class":281},[275,3519,298],{"class":281},[275,3521,301],{"class":281},[275,3523,3524,3526,3528,3530,3532,3534,3536,3538],{"class":277,"line":331},[275,3525,700],{"class":281},[275,3527,1567],{"class":310},[275,3529,295],{"class":281},[275,3531,298],{"class":281},[275,3533,318],{"class":281},[275,3535,1576],{"class":321},[275,3537,295],{"class":281},[275,3539,430],{"class":281},[275,3541,3542,3544,3546,3548,3550,3552,3554,3556],{"class":277,"line":337},[275,3543,700],{"class":281},[275,3545,244],{"class":310},[275,3547,295],{"class":281},[275,3549,298],{"class":281},[275,3551,318],{"class":281},[275,3553,257],{"class":321},[275,3555,295],{"class":281},[275,3557,430],{"class":281},[275,3559,3560,3562,3564,3566,3568,3570,3572,3574],{"class":277,"line":359},[275,3561,700],{"class":281},[275,3563,179],{"class":310},[275,3565,295],{"class":281},[275,3567,298],{"class":281},[275,3569,318],{"class":281},[275,3571,1705],{"class":321},[275,3573,295],{"class":281},[275,3575,430],{"class":281},[275,3577,3578,3580,3582,3584,3586,3588,3590,3592],{"class":277,"line":453},[275,3579,700],{"class":281},[275,3581,165],{"class":310},[275,3583,295],{"class":281},[275,3585,298],{"class":281},[275,3587,318],{"class":281},[275,3589,895],{"class":321},[275,3591,295],{"class":281},[275,3593,430],{"class":281},[275,3595,3596,3598,3600,3602,3604,3606,3608,3610],{"class":277,"line":576},[275,3597,700],{"class":281},[275,3599,1659],{"class":310},[275,3601,295],{"class":281},[275,3603,298],{"class":281},[275,3605,318],{"class":281},[275,3607,2622],{"class":321},[275,3609,295],{"class":281},[275,3611,430],{"class":281},[275,3613,3614,3616,3618,3620,3622,3624,3626,3628],{"class":277,"line":583},[275,3615,700],{"class":281},[275,3617,311],{"class":310},[275,3619,295],{"class":281},[275,3621,298],{"class":281},[275,3623,318],{"class":281},[275,3625,322],{"class":321},[275,3627,295],{"class":281},[275,3629,430],{"class":281},[275,3631,3632,3634,3637,3639,3641,3643,3645,3647],{"class":277,"line":604},[275,3633,700],{"class":281},[275,3635,3636],{"class":310},"captured_amount",[275,3638,295],{"class":281},[275,3640,298],{"class":281},[275,3642,318],{"class":281},[275,3644,2976],{"class":321},[275,3646,295],{"class":281},[275,3648,430],{"class":281},[275,3650,3651,3653,3656,3658,3660,3662,3665,3667],{"class":277,"line":609},[275,3652,700],{"class":281},[275,3654,3655],{"class":310},"released_amount",[275,3657,295],{"class":281},[275,3659,298],{"class":281},[275,3661,318],{"class":281},[275,3663,3664],{"class":321},"50.00",[275,3666,295],{"class":281},[275,3668,430],{"class":281},[275,3670,3671,3673,3675,3677,3679,3681,3683,3685],{"class":277,"line":630},[275,3672,700],{"class":281},[275,3674,557],{"class":310},[275,3676,295],{"class":281},[275,3678,298],{"class":281},[275,3680,318],{"class":281},[275,3682,566],{"class":321},[275,3684,295],{"class":281},[275,3686,430],{"class":281},[275,3688,3689,3691,3693,3695,3697,3699,3701,3703],{"class":277,"line":635},[275,3690,700],{"class":281},[275,3692,342],{"class":310},[275,3694,295],{"class":281},[275,3696,298],{"class":281},[275,3698,318],{"class":281},[275,3700,2904],{"class":321},[275,3702,295],{"class":281},[275,3704,430],{"class":281},[275,3706,3707,3709,3712,3714,3716,3718,3721,3723],{"class":277,"line":659},[275,3708,700],{"class":281},[275,3710,3711],{"class":310},"invoice_id",[275,3713,295],{"class":281},[275,3715,298],{"class":281},[275,3717,318],{"class":281},[275,3719,3720],{"class":321},"inv_k2Jd8sLqPz...",[275,3722,295],{"class":281},[275,3724,430],{"class":281},[275,3726,3727,3729,3732,3734,3736,3738,3741],{"class":277,"line":664},[275,3728,700],{"class":281},[275,3730,3731],{"class":310},"captured_at",[275,3733,295],{"class":281},[275,3735,298],{"class":281},[275,3737,318],{"class":281},[275,3739,3740],{"class":321},"2026-07-08T09:20:00Z",[275,3742,407],{"class":281},[275,3744,3745],{"class":277,"line":670},[275,3746,789],{"class":281},[275,3748,3749],{"class":277,"line":676},[275,3750,362],{"class":281},[200,3752,2508],{"id":3753},"response-parameters-1",[214,3755,3756,3772],{},[217,3757,3758],{},[220,3759,3760,3764,3766,3770],{},[223,3761,3762],{"align":225},[1088,3763,1091],{"style":1090},[223,3765,229],{"align":225},[223,3767,3768],{"align":225},[1088,3769,232],{"style":1101},[223,3771,235],{"align":225},[237,3773,3774,3785,3796,3806,3817,3828,3845,3856,3868,3880,3895,3906,3923],{},[220,3775,3776,3778,3780,3783],{},[242,3777,1540],{"align":225},[242,3779,1353],{"align":225},[242,3781,3782],{"align":225},"Whether the capture succeeded",[242,3784,1363],{"align":225},[220,3786,3787,3789,3791,3794],{},[242,3788,2544],{"align":225},[242,3790,247],{"align":225},[242,3792,3793],{"align":225},"The pre-auth this capture belongs to",[242,3795,1576],{"align":225},[220,3797,3798,3800,3802,3804],{},[242,3799,2556],{"align":225},[242,3801,247],{"align":225},[242,3803,2561],{"align":225},[242,3805,257],{"align":225},[220,3807,3808,3810,3812,3815],{},[242,3809,2657],{"align":225},[242,3811,247],{"align":225},[242,3813,3814],{"align":225},"The captured transaction",[242,3816,1705],{"align":225},[220,3818,3819,3821,3823,3826],{},[242,3820,2641],{"align":225},[242,3822,247],{"align":225},[242,3824,3825],{"align":225},"The card the funds were captured from",[242,3827,895],{"align":225},[220,3829,3830,3832,3834,3841],{},[242,3831,2609],{"align":225},[242,3833,2612],{"align":225},[242,3835,3836,3838,3839],{"align":225},[163,3837,2622],{}," on success, see ",[171,3840,1426],{"href":1425},[242,3842,3843],{"align":225},[163,3844,2622],{},[220,3846,3847,3849,3851,3854],{},[242,3848,2568],{"align":225},[242,3850,1130],{"align":225},[242,3852,3853],{"align":225},"Original held amount",[242,3855,322],{"align":225},[220,3857,3858,3861,3863,3866],{},[242,3859,3860],{"align":225},"result.captured_amount",[242,3862,1130],{"align":225},[242,3864,3865],{"align":225},"Amount settled",[242,3867,2976],{"align":225},[220,3869,3870,3873,3875,3878],{},[242,3871,3872],{"align":225},"result.released_amount",[242,3874,1130],{"align":225},[242,3876,3877],{"align":225},"Remainder of the hold released back to the cardholder",[242,3879,3664],{"align":225},[220,3881,3882,3884,3886,3891],{},[242,3883,2580],{"align":225},[242,3885,1180],{"align":225},[242,3887,3888,2588],{"align":225},[171,3889,1189],{"href":1185,"rel":3890,":target":1188},[1187],[242,3892,3893],{"align":225},[163,3894,566],{},[220,3896,3897,3899,3901,3904],{},[242,3898,2597],{"align":225},[242,3900,1205],{"align":225},[242,3902,3903],{"align":225},"Reference used for the capture",[242,3905,2904],{"align":225},[220,3907,3908,3911,3913,3921],{},[242,3909,3910],{"align":225},"result.invoice_id",[242,3912,247],{"align":225},[242,3914,3915,3916,3918,3919],{"align":225},"Invoice identifier; present when ",[163,3917,3431],{}," was ",[163,3920,1363],{},[242,3922,3720],{"align":225},[220,3924,3925,3928,3930,3933],{},[242,3926,3927],{"align":225},"result.captured_at",[242,3929,1130],{"align":225},[242,3931,3932],{"align":225},"ISO timestamp when the capture completed",[242,3934,3740],{"align":225},[154,3936,3938],{"id":3937},"reverse-request","Reverse Request",[159,3940,3941,3942,2821,3944,3946,3947,3949],{},"Release a previously authorised hold without settling any funds, by passing the ",[163,3943,179],{},[171,3945,2825],{"href":2824},". The full held amount is returned to the cardholder's available balance. A pre-auth can only be reversed while its status is ",[163,3948,1668],{},"; expired holds are released automatically.",[200,3951,203],{"id":3952},"path-2",[159,3954,3955,209,3957],{},[163,3956,208],{},[163,3958,3959],{},"\u002Fcard-vault\u002Fpre-auth\u002F{transaction_id}\u002Freverse",[214,3961,3962,3974],{},[217,3963,3964],{},[220,3965,3966,3968,3970,3972],{},[223,3967,226],{"align":225},[223,3969,229],{"align":225},[223,3971,232],{"align":225},[223,3973,235],{"align":225},[237,3975,3976],{},[220,3977,3978,3980,3982,3984],{},[242,3979,179],{"align":225},[242,3981,247],{"align":225},[242,3983,2867],{"align":225},[242,3985,1705],{"align":225},[200,3987,235],{"id":3988},"example",[159,3990,3991,3992,2880],{},"An empty body (or ",[163,3993,2879],{},[266,3995,3997],{"className":268,"code":3996,"language":270,"meta":271,"style":271},"{\n  \"reason\": \"Booking cancelled by customer\", \u002F\u002F [optional] recorded against the reversal for reporting\n\n  \"signature\": \"secret-key-for-payload\", \u002F\u002F [optional] shared-secret signature for the payload, see the signature section below\n\n  \"notification\": {\n    \"email\": \"me@my-email.co.za\", \u002F\u002F [optional] email notification on the reversal outcome\n    \"webhook_url\": \"https:\u002F\u002Fmerchant.example\u002Fwebhooks\u002Fpayments\" \u002F\u002F [optional] overrides the webhook URL supplied on the pre-auth\n  }\n}\n",[163,3998,3999,4003,4026,4030,4050,4054,4066,4087,4105,4109],{"__ignoreMap":271},[275,4000,4001],{"class":277,"line":278},[275,4002,282],{"class":281},[275,4004,4005,4007,4010,4012,4014,4016,4019,4021,4023],{"class":277,"line":285},[275,4006,288],{"class":281},[275,4008,4009],{"class":291},"reason",[275,4011,295],{"class":281},[275,4013,298],{"class":281},[275,4015,318],{"class":281},[275,4017,4018],{"class":321},"Booking cancelled by customer",[275,4020,295],{"class":281},[275,4022,522],{"class":281},[275,4024,4025],{"class":327}," \u002F\u002F [optional] recorded against the reversal for reporting\n",[275,4027,4028],{"class":277,"line":304},[275,4029,580],{"emptyLinePlaceholder":579},[275,4031,4032,4034,4036,4038,4040,4042,4044,4046,4048],{"class":277,"line":331},[275,4033,288],{"class":281},[275,4035,640],{"class":291},[275,4037,295],{"class":281},[275,4039,298],{"class":281},[275,4041,318],{"class":281},[275,4043,649],{"class":321},[275,4045,295],{"class":281},[275,4047,522],{"class":281},[275,4049,656],{"class":327},[275,4051,4052],{"class":277,"line":337},[275,4053,580],{"emptyLinePlaceholder":579},[275,4055,4056,4058,4060,4062,4064],{"class":277,"line":359},[275,4057,288],{"class":281},[275,4059,948],{"class":291},[275,4061,295],{"class":281},[275,4063,298],{"class":281},[275,4065,301],{"class":281},[275,4067,4068,4070,4072,4074,4076,4078,4080,4082,4084],{"class":277,"line":453},[275,4069,307],{"class":281},[275,4071,962],{"class":310},[275,4073,295],{"class":281},[275,4075,298],{"class":281},[275,4077,318],{"class":281},[275,4079,971],{"class":321},[275,4081,295],{"class":281},[275,4083,522],{"class":281},[275,4085,4086],{"class":327}," \u002F\u002F [optional] email notification on the reversal outcome\n",[275,4088,4089,4091,4093,4095,4097,4099,4101,4103],{"class":277,"line":576},[275,4090,307],{"class":281},[275,4092,986],{"class":310},[275,4094,295],{"class":281},[275,4096,298],{"class":281},[275,4098,318],{"class":281},[275,4100,995],{"class":321},[275,4102,295],{"class":281},[275,4104,3249],{"class":327},[275,4106,4107],{"class":277,"line":583},[275,4108,1052],{"class":281},[275,4110,4111],{"class":277,"line":604},[275,4112,362],{"class":281},[200,4114,1061],{"id":4115},"request-parameters-2",[214,4117,4118,4136],{},[217,4119,4120],{},[220,4121,4122,4126,4128,4130,4134],{},[223,4123,4124],{"align":225},[1088,4125,1091],{"style":1090},[223,4127,1094],{"align":225},[223,4129,229],{"align":225},[223,4131,4132],{"align":225},[1088,4133,232],{"style":1101},[223,4135,235],{"align":225},[237,4137,4138,4151,4163,4178],{},[220,4139,4140,4142,4144,4146,4149],{},[242,4141,4009],{"align":225},[242,4143,1143],{"align":225},[242,4145,1130],{"align":225},[242,4147,4148],{"align":225},"Optional reason recorded against the reversal for reporting",[242,4150,4018],{"align":225},[220,4152,4153,4155,4157,4159,4161],{},[242,4154,640],{"align":225},[242,4156,1143],{"align":225},[242,4158,1130],{"align":225},[242,4160,1442],{"align":225},[242,4162,649],{"align":225},[220,4164,4165,4167,4169,4171,4174],{},[242,4166,1449],{"align":225},[242,4168,1143],{"align":225},[242,4170,1130],{"align":225},[242,4172,4173],{"align":225},"Email address to notify on the reversal outcome",[242,4175,4176],{"align":225},[171,4177,971],{"href":1461},[220,4179,4180,4182,4184,4186,4189],{},[242,4181,1466],{"align":225},[242,4183,1143],{"align":225},[242,4185,1130],{"align":225},[242,4187,4188],{"align":225},"Webhook URL for the reversal outcome; overrides the URL supplied on the pre-auth",[242,4190,4191],{"align":225},[171,4192,995],{"href":995,"rel":4193},[1187],[200,4195,1498],{"id":4196},"response-body-2",[266,4198,4200],{"className":268,"code":4199,"language":270,"meta":271,"style":271},"{\n    \"status\": true,\n    \"result\": {\n      \"id\": \"pre_Wt5RmK2xPqLv9nYcE7aBz\",\n      \"customer_id\": \"cus_abc123...\",\n      \"transaction_id\": \"tra_pr6CvR_4pvWwmgQ4y3dtY\",\n      \"card_id\": \"crd_9kLmXw3RtYqPz8vNcE2aB\",\n      \"pre_auth_status\": \"REVERSED\",\n      \"amount\": \"349.00\",\n      \"released_amount\": \"349.00\",\n      \"currency\": \"ZAR\",\n      \"reference\": \"INV-2026-00042\",\n      \"reversed_at\": \"2026-07-08T09:20:00Z\"\n    }\n}\n",[163,4201,4202,4206,4218,4230,4248,4266,4284,4302,4320,4338,4356,4374,4392,4409,4413],{"__ignoreMap":271},[275,4203,4204],{"class":277,"line":278},[275,4205,282],{"class":281},[275,4207,4208,4210,4212,4214,4216],{"class":277,"line":285},[275,4209,307],{"class":281},[275,4211,1540],{"class":291},[275,4213,295],{"class":281},[275,4215,298],{"class":281},[275,4217,1547],{"class":281},[275,4219,4220,4222,4224,4226,4228],{"class":277,"line":304},[275,4221,307],{"class":281},[275,4223,1554],{"class":291},[275,4225,295],{"class":281},[275,4227,298],{"class":281},[275,4229,301],{"class":281},[275,4231,4232,4234,4236,4238,4240,4242,4244,4246],{"class":277,"line":331},[275,4233,700],{"class":281},[275,4235,1567],{"class":310},[275,4237,295],{"class":281},[275,4239,298],{"class":281},[275,4241,318],{"class":281},[275,4243,1576],{"class":321},[275,4245,295],{"class":281},[275,4247,430],{"class":281},[275,4249,4250,4252,4254,4256,4258,4260,4262,4264],{"class":277,"line":337},[275,4251,700],{"class":281},[275,4253,244],{"class":310},[275,4255,295],{"class":281},[275,4257,298],{"class":281},[275,4259,318],{"class":281},[275,4261,257],{"class":321},[275,4263,295],{"class":281},[275,4265,430],{"class":281},[275,4267,4268,4270,4272,4274,4276,4278,4280,4282],{"class":277,"line":359},[275,4269,700],{"class":281},[275,4271,179],{"class":310},[275,4273,295],{"class":281},[275,4275,298],{"class":281},[275,4277,318],{"class":281},[275,4279,1705],{"class":321},[275,4281,295],{"class":281},[275,4283,430],{"class":281},[275,4285,4286,4288,4290,4292,4294,4296,4298,4300],{"class":277,"line":453},[275,4287,700],{"class":281},[275,4289,165],{"class":310},[275,4291,295],{"class":281},[275,4293,298],{"class":281},[275,4295,318],{"class":281},[275,4297,895],{"class":321},[275,4299,295],{"class":281},[275,4301,430],{"class":281},[275,4303,4304,4306,4308,4310,4312,4314,4316,4318],{"class":277,"line":576},[275,4305,700],{"class":281},[275,4307,1659],{"class":310},[275,4309,295],{"class":281},[275,4311,298],{"class":281},[275,4313,318],{"class":281},[275,4315,2625],{"class":321},[275,4317,295],{"class":281},[275,4319,430],{"class":281},[275,4321,4322,4324,4326,4328,4330,4332,4334,4336],{"class":277,"line":583},[275,4323,700],{"class":281},[275,4325,311],{"class":310},[275,4327,295],{"class":281},[275,4329,298],{"class":281},[275,4331,318],{"class":281},[275,4333,322],{"class":321},[275,4335,295],{"class":281},[275,4337,430],{"class":281},[275,4339,4340,4342,4344,4346,4348,4350,4352,4354],{"class":277,"line":604},[275,4341,700],{"class":281},[275,4343,3655],{"class":310},[275,4345,295],{"class":281},[275,4347,298],{"class":281},[275,4349,318],{"class":281},[275,4351,322],{"class":321},[275,4353,295],{"class":281},[275,4355,430],{"class":281},[275,4357,4358,4360,4362,4364,4366,4368,4370,4372],{"class":277,"line":609},[275,4359,700],{"class":281},[275,4361,557],{"class":310},[275,4363,295],{"class":281},[275,4365,298],{"class":281},[275,4367,318],{"class":281},[275,4369,566],{"class":321},[275,4371,295],{"class":281},[275,4373,430],{"class":281},[275,4375,4376,4378,4380,4382,4384,4386,4388,4390],{"class":277,"line":630},[275,4377,700],{"class":281},[275,4379,342],{"class":310},[275,4381,295],{"class":281},[275,4383,298],{"class":281},[275,4385,318],{"class":281},[275,4387,351],{"class":321},[275,4389,295],{"class":281},[275,4391,430],{"class":281},[275,4393,4394,4396,4399,4401,4403,4405,4407],{"class":277,"line":635},[275,4395,700],{"class":281},[275,4397,4398],{"class":310},"reversed_at",[275,4400,295],{"class":281},[275,4402,298],{"class":281},[275,4404,318],{"class":281},[275,4406,3740],{"class":321},[275,4408,407],{"class":281},[275,4410,4411],{"class":277,"line":659},[275,4412,789],{"class":281},[275,4414,4415],{"class":277,"line":664},[275,4416,362],{"class":281},[200,4418,2508],{"id":4419},"response-parameters-2",[214,4421,4422,4438],{},[217,4423,4424],{},[220,4425,4426,4430,4432,4436],{},[223,4427,4428],{"align":225},[1088,4429,1091],{"style":1090},[223,4431,229],{"align":225},[223,4433,4434],{"align":225},[1088,4435,232],{"style":1101},[223,4437,235],{"align":225},[237,4439,4440,4451,4462,4472,4483,4494,4510,4520,4531,4546,4557],{},[220,4441,4442,4444,4446,4449],{},[242,4443,1540],{"align":225},[242,4445,1353],{"align":225},[242,4447,4448],{"align":225},"Whether the reversal succeeded",[242,4450,1363],{"align":225},[220,4452,4453,4455,4457,4460],{},[242,4454,2544],{"align":225},[242,4456,247],{"align":225},[242,4458,4459],{"align":225},"The pre-auth this reversal belongs to",[242,4461,1576],{"align":225},[220,4463,4464,4466,4468,4470],{},[242,4465,2556],{"align":225},[242,4467,247],{"align":225},[242,4469,2561],{"align":225},[242,4471,257],{"align":225},[220,4473,4474,4476,4478,4481],{},[242,4475,2657],{"align":225},[242,4477,247],{"align":225},[242,4479,4480],{"align":225},"The reversed transaction",[242,4482,1705],{"align":225},[220,4484,4485,4487,4489,4492],{},[242,4486,2641],{"align":225},[242,4488,247],{"align":225},[242,4490,4491],{"align":225},"The card the hold was released from",[242,4493,895],{"align":225},[220,4495,4496,4498,4500,4506],{},[242,4497,2609],{"align":225},[242,4499,2612],{"align":225},[242,4501,4502,3838,4504],{"align":225},[163,4503,2625],{},[171,4505,1426],{"href":1425},[242,4507,4508],{"align":225},[163,4509,2625],{},[220,4511,4512,4514,4516,4518],{},[242,4513,2568],{"align":225},[242,4515,1130],{"align":225},[242,4517,3853],{"align":225},[242,4519,322],{"align":225},[220,4521,4522,4524,4526,4529],{},[242,4523,3872],{"align":225},[242,4525,1130],{"align":225},[242,4527,4528],{"align":225},"Amount released back to the cardholder",[242,4530,322],{"align":225},[220,4532,4533,4535,4537,4542],{},[242,4534,2580],{"align":225},[242,4536,1180],{"align":225},[242,4538,4539,2588],{"align":225},[171,4540,1189],{"href":1185,"rel":4541,":target":1188},[1187],[242,4543,4544],{"align":225},[163,4545,566],{},[220,4547,4548,4550,4552,4555],{},[242,4549,2597],{"align":225},[242,4551,1205],{"align":225},[242,4553,4554],{"align":225},"Your reference from the original pre-auth",[242,4556,351],{"align":225},[220,4558,4559,4562,4564,4567],{},[242,4560,4561],{"align":225},"result.reversed_at",[242,4563,1130],{"align":225},[242,4565,4566],{"align":225},"ISO timestamp when the reversal completed",[242,4568,3740],{"align":225},[154,4570,4572],{"id":4571},"signature-creation","Signature creation",[159,4574,4575,4576,4578,4579,4583],{},"When creating API keys on the dashboard you can download a passphrase key, use it to generate your signature and send it in the ",[163,4577,640],{}," parameter. The canonicalization and HMAC-SHA256 process is identical across all endpoints — see ",[171,4580,4582],{"href":4581},"\u002Fv2\u002Fmoney-in\u002Fcheckout-link#signature-creation","Checkout Link — Signature creation"," for Node.js, PHP, C#, Java, and Python examples.",[154,4585,4587],{"id":4586},"webhook","Webhook",[159,4589,4590,4591,4593],{},"Webhooks are delivered to ",[163,4592,1466],{}," for each pre-auth lifecycle event when that field was supplied. Broader platform webhooks are configured separately if applicable. Webhooks fire once per pre-auth outcome, not per cascade attempt.",[159,4595,4596,4597,4600,4601,1415,4604,1415,4607,1415,4610,4613,4614,4617,4618,2832],{},"Possible ",[163,4598,4599],{},"event"," values include ",[163,4602,4603],{},"preauth.successful",[163,4605,4606],{},"preauth.failed",[163,4608,4609],{},"preauth.captured",[163,4611,4612],{},"preauth.reversed",", and ",[163,4615,4616],{},"preauth.expired",", listed under ",[171,4619,4621],{"href":4620},"#webhook-events","Webhook events",[200,4623,4625],{"id":4624},"webhook-payload","Webhook Payload",[266,4627,4629],{"className":268,"code":4628,"language":270,"meta":271,"style":271},"{\n  \u002F\u002F preauth.successful · preauth.failed · preauth.captured · preauth.reversed · preauth.expired\n  \"event\": \"preauth.captured\",\n  \"data\": [\n    {\n      \"pre_auth\": {\n        \"id\": \"pre_Wt5RmK2xPqLv9nYcE7aBz\",\n        \"customer_id\": \"cus_abc123...\",\n        \"amount\": \"349.00\",\n        \"captured_amount\": \"299.00\", \u002F\u002F present on preauth.captured\n        \"released_amount\": \"50.00\", \u002F\u002F present on preauth.captured \u002F preauth.reversed \u002F preauth.expired\n        \"currency\": \"ZAR\",\n        \"reference\": \"INV-2026-00042-CAP\",\n        \"pre_auth_status\": \"CAPTURED\",\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\": \"CAPTURED\"\n          }\n        ],\n        \"invoice_id\": \"inv_k2Jd8sLqPz...\",\n        \"metadata\": {\n          \"order_id\": \"ord_98765\"\n        },\n        \"expires_at\": \"2026-07-13T10:15:30Z\",\n        \"completed_at\": \"2026-07-08T09:20:00Z\"\n      }\n    }\n  ],\n  \"created_at\": \"2026-07-08T09:20:00Z\"\n}\n",[163,4630,4631,4635,4640,4658,4671,4675,4688,4707,4725,4743,4764,4785,4803,4821,4839,4857,4875,4887,4892,4906,4924,4936,4954,4972,4984,5004,5020,5025,5030,5034,5048,5066,5078,5096,5112,5116,5121,5139,5151,5167,5171,5189,5206,5211,5215,5219,5235],{"__ignoreMap":271},[275,4632,4633],{"class":277,"line":278},[275,4634,282],{"class":281},[275,4636,4637],{"class":277,"line":285},[275,4638,4639],{"class":327},"  \u002F\u002F preauth.successful · preauth.failed · preauth.captured · preauth.reversed · preauth.expired\n",[275,4641,4642,4644,4646,4648,4650,4652,4654,4656],{"class":277,"line":304},[275,4643,288],{"class":281},[275,4645,4599],{"class":291},[275,4647,295],{"class":281},[275,4649,298],{"class":281},[275,4651,318],{"class":281},[275,4653,4609],{"class":321},[275,4655,295],{"class":281},[275,4657,430],{"class":281},[275,4659,4660,4662,4665,4667,4669],{"class":277,"line":331},[275,4661,288],{"class":281},[275,4663,4664],{"class":291},"data",[275,4666,295],{"class":281},[275,4668,298],{"class":281},[275,4670,688],{"class":281},[275,4672,4673],{"class":277,"line":337},[275,4674,694],{"class":281},[275,4676,4677,4679,4682,4684,4686],{"class":277,"line":359},[275,4678,700],{"class":281},[275,4680,4681],{"class":310},"pre_auth",[275,4683,295],{"class":281},[275,4685,298],{"class":281},[275,4687,301],{"class":281},[275,4689,4690,4693,4695,4697,4699,4701,4703,4705],{"class":277,"line":453},[275,4691,4692],{"class":281},"        \"",[275,4694,1567],{"class":621},[275,4696,295],{"class":281},[275,4698,298],{"class":281},[275,4700,318],{"class":281},[275,4702,1576],{"class":321},[275,4704,295],{"class":281},[275,4706,430],{"class":281},[275,4708,4709,4711,4713,4715,4717,4719,4721,4723],{"class":277,"line":576},[275,4710,4692],{"class":281},[275,4712,244],{"class":621},[275,4714,295],{"class":281},[275,4716,298],{"class":281},[275,4718,318],{"class":281},[275,4720,257],{"class":321},[275,4722,295],{"class":281},[275,4724,430],{"class":281},[275,4726,4727,4729,4731,4733,4735,4737,4739,4741],{"class":277,"line":583},[275,4728,4692],{"class":281},[275,4730,311],{"class":621},[275,4732,295],{"class":281},[275,4734,298],{"class":281},[275,4736,318],{"class":281},[275,4738,322],{"class":321},[275,4740,295],{"class":281},[275,4742,430],{"class":281},[275,4744,4745,4747,4749,4751,4753,4755,4757,4759,4761],{"class":277,"line":604},[275,4746,4692],{"class":281},[275,4748,3636],{"class":621},[275,4750,295],{"class":281},[275,4752,298],{"class":281},[275,4754,318],{"class":281},[275,4756,2976],{"class":321},[275,4758,295],{"class":281},[275,4760,522],{"class":281},[275,4762,4763],{"class":327}," \u002F\u002F present on preauth.captured\n",[275,4765,4766,4768,4770,4772,4774,4776,4778,4780,4782],{"class":277,"line":609},[275,4767,4692],{"class":281},[275,4769,3655],{"class":621},[275,4771,295],{"class":281},[275,4773,298],{"class":281},[275,4775,318],{"class":281},[275,4777,3664],{"class":321},[275,4779,295],{"class":281},[275,4781,522],{"class":281},[275,4783,4784],{"class":327}," \u002F\u002F present on preauth.captured \u002F preauth.reversed \u002F preauth.expired\n",[275,4786,4787,4789,4791,4793,4795,4797,4799,4801],{"class":277,"line":630},[275,4788,4692],{"class":281},[275,4790,557],{"class":621},[275,4792,295],{"class":281},[275,4794,298],{"class":281},[275,4796,318],{"class":281},[275,4798,566],{"class":321},[275,4800,295],{"class":281},[275,4802,430],{"class":281},[275,4804,4805,4807,4809,4811,4813,4815,4817,4819],{"class":277,"line":635},[275,4806,4692],{"class":281},[275,4808,342],{"class":621},[275,4810,295],{"class":281},[275,4812,298],{"class":281},[275,4814,318],{"class":281},[275,4816,2904],{"class":321},[275,4818,295],{"class":281},[275,4820,430],{"class":281},[275,4822,4823,4825,4827,4829,4831,4833,4835,4837],{"class":277,"line":659},[275,4824,4692],{"class":281},[275,4826,1659],{"class":621},[275,4828,295],{"class":281},[275,4830,298],{"class":281},[275,4832,318],{"class":281},[275,4834,2622],{"class":321},[275,4836,295],{"class":281},[275,4838,430],{"class":281},[275,4840,4841,4843,4845,4847,4849,4851,4853,4855],{"class":277,"line":664},[275,4842,4692],{"class":281},[275,4844,165],{"class":621},[275,4846,295],{"class":281},[275,4848,298],{"class":281},[275,4850,318],{"class":281},[275,4852,895],{"class":321},[275,4854,295],{"class":281},[275,4856,430],{"class":281},[275,4858,4859,4861,4863,4865,4867,4869,4871,4873],{"class":277,"line":670},[275,4860,4692],{"class":281},[275,4862,179],{"class":621},[275,4864,295],{"class":281},[275,4866,298],{"class":281},[275,4868,318],{"class":281},[275,4870,1705],{"class":321},[275,4872,295],{"class":281},[275,4874,430],{"class":281},[275,4876,4877,4879,4881,4883,4885],{"class":277,"line":676},[275,4878,4692],{"class":281},[275,4880,1511],{"class":621},[275,4882,295],{"class":281},[275,4884,298],{"class":281},[275,4886,688],{"class":281},[275,4888,4889],{"class":277,"line":691},[275,4890,4891],{"class":281},"          {\n",[275,4893,4894,4896,4898,4900,4902,4904],{"class":277,"line":697},[275,4895,1831],{"class":281},[275,4897,1734],{"class":1834},[275,4899,295],{"class":281},[275,4901,298],{"class":281},[275,4903,1741],{"class":621},[275,4905,430],{"class":281},[275,4907,4908,4910,4912,4914,4916,4918,4920,4922],{"class":277,"line":719},[275,4909,1831],{"class":281},[275,4911,165],{"class":1834},[275,4913,295],{"class":281},[275,4915,298],{"class":281},[275,4917,318],{"class":281},[275,4919,445],{"class":321},[275,4921,295],{"class":281},[275,4923,430],{"class":281},[275,4925,4926,4928,4930,4932,4934],{"class":277,"line":737},[275,4927,1831],{"class":281},[275,4929,1768],{"class":1834},[275,4931,295],{"class":281},[275,4933,298],{"class":281},[275,4935,1547],{"class":281},[275,4937,4938,4940,4942,4944,4946,4948,4950,4952],{"class":277,"line":743},[275,4939,1831],{"class":281},[275,4941,179],{"class":1834},[275,4943,295],{"class":281},[275,4945,298],{"class":281},[275,4947,318],{"class":281},[275,4949,1789],{"class":321},[275,4951,295],{"class":281},[275,4953,430],{"class":281},[275,4955,4956,4958,4960,4962,4964,4966,4968,4970],{"class":277,"line":748},[275,4957,1831],{"class":281},[275,4959,1800],{"class":1834},[275,4961,295],{"class":281},[275,4963,298],{"class":281},[275,4965,318],{"class":281},[275,4967,1809],{"class":321},[275,4969,295],{"class":281},[275,4971,430],{"class":281},[275,4973,4974,4976,4978,4980,4982],{"class":277,"line":768},[275,4975,1831],{"class":281},[275,4977,1820],{"class":1834},[275,4979,295],{"class":281},[275,4981,298],{"class":281},[275,4983,301],{"class":281},[275,4985,4986,4989,4992,4994,4996,4998,5000,5002],{"class":277,"line":786},[275,4987,4988],{"class":281},"              \"",[275,4990,163],{"class":4991},"su27w",[275,4993,295],{"class":281},[275,4995,298],{"class":281},[275,4997,318],{"class":281},[275,4999,1843],{"class":321},[275,5001,295],{"class":281},[275,5003,430],{"class":281},[275,5005,5006,5008,5010,5012,5014,5016,5018],{"class":277,"line":792},[275,5007,4988],{"class":281},[275,5009,1854],{"class":4991},[275,5011,295],{"class":281},[275,5013,298],{"class":281},[275,5015,318],{"class":281},[275,5017,1863],{"class":321},[275,5019,407],{"class":281},[275,5021,5022],{"class":277,"line":798},[275,5023,5024],{"class":281},"            }\n",[275,5026,5027],{"class":277,"line":803},[275,5028,5029],{"class":281},"          },\n",[275,5031,5032],{"class":277,"line":809},[275,5033,4891],{"class":281},[275,5035,5036,5038,5040,5042,5044,5046],{"class":277,"line":823},[275,5037,1831],{"class":281},[275,5039,1734],{"class":1834},[275,5041,295],{"class":281},[275,5043,298],{"class":281},[275,5045,731],{"class":621},[275,5047,430],{"class":281},[275,5049,5050,5052,5054,5056,5058,5060,5062,5064],{"class":277,"line":841},[275,5051,1831],{"class":281},[275,5053,165],{"class":1834},[275,5055,295],{"class":281},[275,5057,298],{"class":281},[275,5059,318],{"class":281},[275,5061,895],{"class":321},[275,5063,295],{"class":281},[275,5065,430],{"class":281},[275,5067,5068,5070,5072,5074,5076],{"class":277,"line":861},[275,5069,1831],{"class":281},[275,5071,1768],{"class":1834},[275,5073,295],{"class":281},[275,5075,298],{"class":281},[275,5077,1924],{"class":281},[275,5079,5080,5082,5084,5086,5088,5090,5092,5094],{"class":277,"line":879},[275,5081,1831],{"class":281},[275,5083,179],{"class":1834},[275,5085,295],{"class":281},[275,5087,298],{"class":281},[275,5089,318],{"class":281},[275,5091,1705],{"class":321},[275,5093,295],{"class":281},[275,5095,430],{"class":281},[275,5097,5098,5100,5102,5104,5106,5108,5110],{"class":277,"line":890},[275,5099,1831],{"class":281},[275,5101,1800],{"class":1834},[275,5103,295],{"class":281},[275,5105,298],{"class":281},[275,5107,318],{"class":281},[275,5109,2622],{"class":321},[275,5111,407],{"class":281},[275,5113,5114],{"class":277,"line":900},[275,5115,1870],{"class":281},[275,5117,5118],{"class":277,"line":906},[275,5119,5120],{"class":281},"        ],\n",[275,5122,5123,5125,5127,5129,5131,5133,5135,5137],{"class":277,"line":933},[275,5124,4692],{"class":281},[275,5126,3711],{"class":621},[275,5128,295],{"class":281},[275,5130,298],{"class":281},[275,5132,318],{"class":281},[275,5134,3720],{"class":321},[275,5136,295],{"class":281},[275,5138,430],{"class":281},[275,5140,5141,5143,5145,5147,5149],{"class":277,"line":938},[275,5142,4692],{"class":281},[275,5144,1018],{"class":621},[275,5146,295],{"class":281},[275,5148,298],{"class":281},[275,5150,301],{"class":281},[275,5152,5153,5155,5157,5159,5161,5163,5165],{"class":277,"line":943},[275,5154,1731],{"class":281},[275,5156,1032],{"class":1834},[275,5158,295],{"class":281},[275,5160,298],{"class":281},[275,5162,318],{"class":281},[275,5164,1041],{"class":321},[275,5166,407],{"class":281},[275,5168,5169],{"class":277,"line":957},[275,5170,1875],{"class":281},[275,5172,5173,5175,5177,5179,5181,5183,5185,5187],{"class":277,"line":981},[275,5174,4692],{"class":281},[275,5176,197],{"class":621},[275,5178,295],{"class":281},[275,5180,298],{"class":281},[275,5182,318],{"class":281},[275,5184,1983],{"class":321},[275,5186,295],{"class":281},[275,5188,430],{"class":281},[275,5190,5191,5193,5196,5198,5200,5202,5204],{"class":277,"line":1003},[275,5192,4692],{"class":281},[275,5194,5195],{"class":621},"completed_at",[275,5197,295],{"class":281},[275,5199,298],{"class":281},[275,5201,318],{"class":281},[275,5203,3740],{"class":321},[275,5205,407],{"class":281},[275,5207,5208],{"class":277,"line":1008},[275,5209,5210],{"class":281},"      }\n",[275,5212,5213],{"class":277,"line":1013},[275,5214,789],{"class":281},[275,5216,5217],{"class":277,"line":1027},[275,5218,795],{"class":281},[275,5220,5221,5223,5225,5227,5229,5231,5233],{"class":277,"line":1049},[275,5222,288],{"class":281},[275,5224,1994],{"class":291},[275,5226,295],{"class":281},[275,5228,298],{"class":281},[275,5230,318],{"class":281},[275,5232,3740],{"class":321},[275,5234,407],{"class":281},[275,5236,5237],{"class":277,"line":1055},[275,5238,362],{"class":281},[200,5240,5242],{"id":5241},"webhook-payload-parameters","Webhook Payload Parameters",[214,5244,5245,5262],{},[217,5246,5247],{},[220,5248,5249,5254,5256,5260],{},[223,5250,5251],{"align":225},[1088,5252,1091],{"style":5253},"width:120px",[223,5255,229],{"align":225},[223,5257,5258],{"align":225},[1088,5259,232],{"style":1101},[223,5261,235],{"align":225},[237,5263,5264,5275,5288,5302,5315,5328,5344,5364,5382,5396,5414,5431,5447,5462,5481,5497,5510,5524],{},[220,5265,5266,5268,5270,5273],{},[242,5267,4599],{"align":225},[242,5269,1130],{"align":225},[242,5271,5272],{"align":225},"Type of webhook event that occurred",[242,5274,4609],{"align":225},[220,5276,5277,5279,5281,5284],{},[242,5278,4664],{"align":225},[242,5280,1257],{"align":225},[242,5282,5283],{"align":225},"Array containing pre-auth data",[242,5285,5286],{"align":225},[275,5287,2681],{},[220,5289,5290,5295,5297,5300],{},[242,5291,4664,5292,5294],{"align":225},[275,5293],{},".pre_auth.id",[242,5296,247],{"align":225},[242,5298,5299],{"align":225},"Unique pre-auth identifier",[242,5301,1576],{"align":225},[220,5303,5304,5309,5311,5313],{},[242,5305,4664,5306,5308],{"align":225},[275,5307],{},".pre_auth.customer_id",[242,5310,247],{"align":225},[242,5312,2561],{"align":225},[242,5314,257],{"align":225},[220,5316,5317,5322,5324,5326],{},[242,5318,4664,5319,5321],{"align":225},[275,5320],{},".pre_auth.amount",[242,5323,1130],{"align":225},[242,5325,3853],{"align":225},[242,5327,322],{"align":225},[220,5329,5330,5335,5337,5342],{},[242,5331,4664,5332,5334],{"align":225},[275,5333],{},".pre_auth.captured_amount",[242,5336,1130],{"align":225},[242,5338,5339,5340],{"align":225},"Amount settled; present on ",[163,5341,4609],{},[242,5343,2976],{"align":225},[220,5345,5346,5351,5353,5362],{},[242,5347,4664,5348,5350],{"align":225},[275,5349],{},".pre_auth.released_amount",[242,5352,1130],{"align":225},[242,5354,5355,5356,1415,5358,4613,5360],{"align":225},"Amount released back to the cardholder; present on ",[163,5357,4609],{},[163,5359,4612],{},[163,5361,4616],{},[242,5363,3664],{"align":225},[220,5365,5366,5371,5373,5378],{},[242,5367,4664,5368,5370],{"align":225},[275,5369],{},".pre_auth.currency",[242,5372,1180],{"align":225},[242,5374,5375,2588],{"align":225},[171,5376,1189],{"href":1185,"rel":5377,":target":1188},[1187],[242,5379,5380],{"align":225},[163,5381,566],{},[220,5383,5384,5389,5391,5394],{},[242,5385,4664,5386,5388],{"align":225},[275,5387],{},".pre_auth.reference",[242,5390,1205],{"align":225},[242,5392,5393],{"align":225},"Reference for this pre-auth or capture",[242,5395,2904],{"align":225},[220,5397,5398,5403,5405,5410],{},[242,5399,4664,5400,5402],{"align":225},[275,5401],{},".pre_auth.pre_auth_status",[242,5404,2612],{"align":225},[242,5406,5407,5408],{"align":225},"Pre-auth state after the event, see ",[171,5409,1426],{"href":1425},[242,5411,5412],{"align":225},[163,5413,2622],{},[220,5415,5416,5421,5423,5429],{},[242,5417,4664,5418,5420],{"align":225},[275,5419],{},".pre_auth.card_id",[242,5422,247],{"align":225},[242,5424,5425,5426,5428],{"align":225},"The card that was authorised; ",[163,5427,2649],{}," on failure",[242,5430,895],{"align":225},[220,5432,5433,5438,5440,5445],{},[242,5434,4664,5435,5437],{"align":225},[275,5436],{},".pre_auth.transaction_id",[242,5439,247],{"align":225},[242,5441,5442,5443,5428],{"align":225},"The authorised transaction; ",[163,5444,2649],{},[242,5446,1705],{"align":225},[220,5448,5449,5454,5456,5458],{},[242,5450,4664,5451,5453],{"align":225},[275,5452],{},".pre_auth.attempts",[242,5455,1257],{"align":225},[242,5457,2676],{"align":225},[242,5459,5460],{"align":225},[275,5461,2681],{},[220,5463,5464,5469,5471,5479],{},[242,5465,4664,5466,5468],{"align":225},[275,5467],{},".pre_auth.invoice_id",[242,5470,247],{"align":225},[242,5472,5473,5474,3918,5476,5478],{"align":225},"Invoice identifier when ",[163,5475,3431],{},[163,5477,1363],{}," on capture",[242,5480,3720],{"align":225},[220,5482,5483,5488,5490,5493],{},[242,5484,4664,5485,5487],{"align":225},[275,5486],{},".pre_auth.metadata",[242,5489,1114],{"align":225},[242,5491,5492],{"align":225},"Custom key\u002Fvalue metadata supplied on create",[242,5494,5495],{"align":225},[163,5496,1494],{},[220,5498,5499,5504,5506,5508],{},[242,5500,4664,5501,5503],{"align":225},[275,5502],{},".pre_auth.expires_at",[242,5505,1130],{"align":225},[242,5507,2797],{"align":225},[242,5509,1983],{"align":225},[220,5511,5512,5517,5519,5522],{},[242,5513,4664,5514,5516],{"align":225},[275,5515],{},".pre_auth.completed_at",[242,5518,1130],{"align":225},[242,5520,5521],{"align":225},"ISO timestamp when the pre-auth reached the status for this event",[242,5523,3740],{"align":225},[220,5525,5526,5528,5530,5533],{},[242,5527,1994],{"align":225},[242,5529,1130],{"align":225},[242,5531,5532],{"align":225},"ISO timestamp when webhook was created",[242,5534,3740],{"align":225},[200,5536,5538],{"id":5537},"webhook-events","Webhook Events",[214,5540,5541,5556],{},[217,5542,5543],{},[220,5544,5545,5548,5550,5553],{},[223,5546,5547],{"align":225},"Event",[223,5549,232],{"align":225},[223,5551,5552],{"align":225},"Trigger Condition",[223,5554,5555],{"align":225},"Data Included",[237,5557,5558,5576,5594,5609,5624],{},[220,5559,5560,5564,5567,5573],{},[242,5561,5562],{"align":225},[163,5563,4603],{},[242,5565,5566],{"align":225},"A hold was placed on one of the customer's cards",[242,5568,5569,5570,5572],{"align":225},"When any cascade attempt (or the specified ",[163,5571,165],{},") is authorised",[242,5574,5575],{"align":225},"Pre-auth details, authorised transaction, full attempt history, hold expiry",[220,5577,5578,5582,5585,5591],{},[242,5579,5580],{"align":225},[163,5581,4606],{},[242,5583,5584],{"align":225},"The pre-auth failed on all attempted cards",[242,5586,5587,5588,5590],{"align":225},"When all cascade attempts decline, a hard decline aborts the cascade, or the specified ",[163,5589,165],{}," declines",[242,5592,5593],{"align":225},"Pre-auth details, full attempt history with decline codes",[220,5595,5596,5600,5603,5606],{},[242,5597,5598],{"align":225},[163,5599,4609],{},[242,5601,5602],{"align":225},"The hold was settled in full or in part",[242,5604,5605],{"align":225},"When a capture request completes",[242,5607,5608],{"align":225},"Pre-auth details, captured and released amounts, invoice when generated",[220,5610,5611,5615,5618,5621],{},[242,5612,5613],{"align":225},[163,5614,4612],{},[242,5616,5617],{"align":225},"The hold was released without settlement",[242,5619,5620],{"align":225},"When a reverse request completes",[242,5622,5623],{"align":225},"Pre-auth details, released amount",[220,5625,5626,5630,5633,5638],{},[242,5627,5628],{"align":225},[163,5629,4616],{},[242,5631,5632],{"align":225},"The hold expired and was released automatically",[242,5634,1356,5635,5637],{"align":225},[163,5636,197],{}," passes without a capture or reversal",[242,5639,5623],{"align":225},[200,5641,5643],{"id":5642},"webhook-security","Webhook Security",[159,5645,5646],{},"All webhooks are sent with the following headers for verification:",[5648,5649,5650,5657,5663],"ul",{},[5651,5652,5653,5656],"li",{},[163,5654,5655],{},"X-Signature",": HMAC-SHA256 signature of the payload",[5651,5658,5659,5662],{},[163,5660,5661],{},"X-Timestamp",": Unix timestamp of when the webhook was sent",[5651,5664,5665,5668,5669],{},[163,5666,5667],{},"User-Agent",": ",[163,5670,5671],{},"Kwik-Webhooks\u002F1.0",[200,5673,5675],{"id":5674},"webhook-response","Webhook Response",[159,5677,5678,5679,5682],{},"Your endpoint should respond with a ",[163,5680,5681],{},"200"," status code to acknowledge receipt. Failed webhooks will be retried up to 3 times with exponential backoff.",[5684,5685,5686],"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 .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}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 .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":271,"searchDepth":278,"depth":285,"links":5688},[5689,5698,5706,5713,5714],{"id":156,"depth":285,"text":157,"children":5690},[5691,5692,5693,5694,5695,5696,5697],{"id":202,"depth":304,"text":203},{"id":260,"depth":304,"text":261},{"id":365,"depth":304,"text":366},{"id":458,"depth":304,"text":459},{"id":1060,"depth":304,"text":1061},{"id":1497,"depth":304,"text":1498},{"id":2507,"depth":304,"text":2508},{"id":2814,"depth":285,"text":2815,"children":5699},[5700,5701,5702,5703,5704,5705],{"id":2835,"depth":304,"text":203},{"id":2872,"depth":304,"text":2873},{"id":2916,"depth":304,"text":2917},{"id":3260,"depth":304,"text":1061},{"id":3488,"depth":304,"text":1498},{"id":3753,"depth":304,"text":2508},{"id":3937,"depth":285,"text":3938,"children":5707},[5708,5709,5710,5711,5712],{"id":3952,"depth":304,"text":203},{"id":3988,"depth":304,"text":235},{"id":4115,"depth":304,"text":1061},{"id":4196,"depth":304,"text":1498},{"id":4419,"depth":304,"text":2508},{"id":4571,"depth":285,"text":4572},{"id":4586,"depth":285,"text":4587,"children":5715},[5716,5717,5718,5719,5720],{"id":4624,"depth":304,"text":4625},{"id":5241,"depth":304,"text":5242},{"id":5537,"depth":304,"text":5538},{"id":5642,"depth":304,"text":5643},{"id":5674,"depth":304,"text":5675},"Place a pre-authorisation hold on a customer's stored cards server-to-server, then capture or reverse it later using the transaction ID. Attempts the default card first with automatic cascade to fallback cards, or targets a specific card. Supports merchant-initiated (MIT) scheme compliance, partial captures, invoice issuance, and webhook notifications.","md",null,{},{"title":103,"description":5721},"kWMBCdQM8G8-vw_CHKR9J0MgEJzKadYXP2x2bzaxPho",[5728,5730],{"title":99,"path":100,"stem":101,"description":5729,"children":-1},"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, and webhook notifications.",{"title":112,"path":113,"stem":114,"description":5731,"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.",1783349992293]