[{"data":1,"prerenderedAt":8816},["ShallowReactive",2],{"page-api\u002Forders-wallet-en":3,"all-content-en":1532},{"id":4,"title":5,"body":6,"category":1523,"description":1524,"extension":1525,"meta":1526,"navigation":1527,"order":363,"path":1528,"seo":1529,"stem":1530,"__hash__":1531},"content_en\u002Fapi\u002F05.orders-wallet.md","Orders, Wallet & Transactions",{"type":7,"value":8,"toc":1505},"minimark",[9,13,22,25,34,43,121,127,222,224,231,237,249,266,268,275,282,289,526,534,536,543,550,643,648,828,849,851,855,859,921,924,986,990,1002,1102,1106,1348,1352,1397,1399,1403,1501],[10,11,5],"h1",{"id":12},"orders-wallet-transactions",[14,15,16,17,21],"p",{},"All endpoints on this page are ",[18,19,20],"strong",{},"read-only",". Use them to poll async operation results, check balances, and retrieve transaction history.",[23,24],"hr",{},[26,27,29,33],"h2",{"id":28},"get-orders-list-orders",[30,31,32],"code",{},"GET \u002Forders"," — list orders",[14,35,36,39,40],{},[18,37,38],{},"Ability",": ",[30,41,42],{},"orders.read",[44,45,46,62],"table",{},[47,48,49],"thead",{},[50,51,52,56,59],"tr",{},[53,54,55],"th",{},"Query",[53,57,58],{},"Type",[53,60,61],{},"Description",[63,64,65,86,105],"tbody",{},[50,66,67,77,80],{},[68,69,70,73,74],"td",{},[30,71,72],{},"page"," \u002F ",[30,75,76],{},"per_page",[68,78,79],{},"int",[68,81,82,83,85],{},"Pagination (",[30,84,76],{}," default 50)",[50,87,88,93,96],{},[68,89,90],{},[30,91,92],{},"status",[68,94,95],{},"string",[68,97,98,99,104],{},"Status filter (see ",[100,101,103],"a",{"href":102},"#order-status","Order status",")",[50,106,107,112,114],{},[68,108,109],{},[30,110,111],{},"type",[68,113,95],{},[68,115,116,117,104],{},"Type filter (see ",[100,118,120],{"href":119},"#order-type","Order type",[14,122,123,126],{},[18,124,125],{},"Each order row",":",[44,128,129,141],{},[47,130,131],{},[50,132,133,136,138],{},[53,134,135],{},"Field",[53,137,58],{},[53,139,140],{},"Notes",[63,142,143,154,167,179,196,210],{},[50,144,145,150,152],{},[68,146,147],{},[30,148,149],{},"uuid",[68,151,149],{},[68,153],{},[50,155,156,160,162],{},[68,157,158],{},[30,159,111],{},[68,161,95],{},[68,163,164,165],{},"See ",[100,166,120],{"href":119},[50,168,169,173,175],{},[68,170,171],{},[30,172,92],{},[68,174,95],{},[68,176,164,177],{},[100,178,103],{"href":102},[50,180,181,186,189],{},[68,182,183],{},[30,184,185],{},"failure_reason",[68,187,188],{},"string?",[68,190,191,192],{},"Null unless failed — see ",[100,193,195],{"href":194},"#order-failure-reason","Failure reason",[50,197,198,206,208],{},[68,199,200,73,203],{},[30,201,202],{},"held_amount",[30,204,205],{},"currency",[68,207,95],{},[68,209],{},[50,211,212,217,220],{},[68,213,214],{},[30,215,216],{},"created_at",[68,218,219],{},"datetime",[68,221],{},[23,223],{},[26,225,227,230],{"id":226},"get-ordersuuid-get-one-order",[30,228,229],{},"GET \u002Forders\u002F{uuid}"," — get one order",[14,232,233,39,235],{},[18,234,38],{},[30,236,42],{},[14,238,239,39,242,245,246],{},[18,240,241],{},"Response",[30,243,244],{},"200"," order detail (same fields as the list, used to poll async results) \u002F ",[30,247,248],{},"404 order.not_found",[14,250,251,254,255,257,258,261,262,265],{},[18,252,253],{},"Polling pattern",": call this endpoint every 2–5 seconds until ",[30,256,92],{}," becomes ",[30,259,260],{},"completed"," or ",[30,263,264],{},"failed",".",[23,267],{},[26,269,271,274],{"id":270},"get-wallet-wallet-balance",[30,272,273],{},"GET \u002Fwallet"," — wallet balance",[14,276,277,39,279],{},[18,278,38],{},[30,280,281],{},"wallet.read",[14,283,284,126],{},[18,285,286,287],{},"Success ",[30,288,244],{},[290,291,296],"pre",{"className":292,"code":293,"language":294,"meta":295,"style":295},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"data\": {\n    \"workspace_id\": 12,\n    \"wallets\": [\n      {\n        \"currency\": \"USD\",\n        \"balance\": \"880.00\",\n        \"held_balance\": \"106.00\",\n        \"available\": \"774.00\",\n        \"frozen_at\": null,\n        \"frozen_reason\": null,\n        \"last_reconciled_at\": \"2026-06-08T00:00:00+00:00\"\n      }\n    ]\n  }\n}\n","json","",[30,297,298,307,325,346,361,367,390,411,432,453,468,482,502,508,514,520],{"__ignoreMap":295},[299,300,303],"span",{"class":301,"line":302},"line",1,[299,304,306],{"class":305},"sMK4o","{\n",[299,308,310,313,317,320,322],{"class":301,"line":309},2,[299,311,312],{"class":305},"  \"",[299,314,316],{"class":315},"spNyl","data",[299,318,319],{"class":305},"\"",[299,321,126],{"class":305},[299,323,324],{"class":305}," {\n",[299,326,328,331,335,337,339,343],{"class":301,"line":327},3,[299,329,330],{"class":305},"    \"",[299,332,334],{"class":333},"sBMFI","workspace_id",[299,336,319],{"class":305},[299,338,126],{"class":305},[299,340,342],{"class":341},"sbssI"," 12",[299,344,345],{"class":305},",\n",[299,347,349,351,354,356,358],{"class":301,"line":348},4,[299,350,330],{"class":305},[299,352,353],{"class":333},"wallets",[299,355,319],{"class":305},[299,357,126],{"class":305},[299,359,360],{"class":305}," [\n",[299,362,364],{"class":301,"line":363},5,[299,365,366],{"class":305},"      {\n",[299,368,370,373,375,377,379,382,386,388],{"class":301,"line":369},6,[299,371,372],{"class":305},"        \"",[299,374,205],{"class":341},[299,376,319],{"class":305},[299,378,126],{"class":305},[299,380,381],{"class":305}," \"",[299,383,385],{"class":384},"sfazB","USD",[299,387,319],{"class":305},[299,389,345],{"class":305},[299,391,393,395,398,400,402,404,407,409],{"class":301,"line":392},7,[299,394,372],{"class":305},[299,396,397],{"class":341},"balance",[299,399,319],{"class":305},[299,401,126],{"class":305},[299,403,381],{"class":305},[299,405,406],{"class":384},"880.00",[299,408,319],{"class":305},[299,410,345],{"class":305},[299,412,414,416,419,421,423,425,428,430],{"class":301,"line":413},8,[299,415,372],{"class":305},[299,417,418],{"class":341},"held_balance",[299,420,319],{"class":305},[299,422,126],{"class":305},[299,424,381],{"class":305},[299,426,427],{"class":384},"106.00",[299,429,319],{"class":305},[299,431,345],{"class":305},[299,433,435,437,440,442,444,446,449,451],{"class":301,"line":434},9,[299,436,372],{"class":305},[299,438,439],{"class":341},"available",[299,441,319],{"class":305},[299,443,126],{"class":305},[299,445,381],{"class":305},[299,447,448],{"class":384},"774.00",[299,450,319],{"class":305},[299,452,345],{"class":305},[299,454,456,458,461,463,465],{"class":301,"line":455},10,[299,457,372],{"class":305},[299,459,460],{"class":341},"frozen_at",[299,462,319],{"class":305},[299,464,126],{"class":305},[299,466,467],{"class":305}," null,\n",[299,469,471,473,476,478,480],{"class":301,"line":470},11,[299,472,372],{"class":305},[299,474,475],{"class":341},"frozen_reason",[299,477,319],{"class":305},[299,479,126],{"class":305},[299,481,467],{"class":305},[299,483,485,487,490,492,494,496,499],{"class":301,"line":484},12,[299,486,372],{"class":305},[299,488,489],{"class":341},"last_reconciled_at",[299,491,319],{"class":305},[299,493,126],{"class":305},[299,495,381],{"class":305},[299,497,498],{"class":384},"2026-06-08T00:00:00+00:00",[299,500,501],{"class":305},"\"\n",[299,503,505],{"class":301,"line":504},13,[299,506,507],{"class":305},"      }\n",[299,509,511],{"class":301,"line":510},14,[299,512,513],{"class":305},"    ]\n",[299,515,517],{"class":301,"line":516},15,[299,518,519],{"class":305},"  }\n",[299,521,523],{"class":301,"line":522},16,[299,524,525],{"class":305},"}\n",[14,527,528,530,531,265],{},[30,529,353],{}," is an array of per-currency balances. All amounts are decimal strings. ",[30,532,533],{},"available = balance − held_balance",[23,535],{},[26,537,539,542],{"id":538},"get-transactions-wallet-ledger",[30,540,541],{},"GET \u002Ftransactions"," — wallet ledger",[14,544,545,39,547],{},[18,546,38],{},[30,548,549],{},"transactions.read",[44,551,552,562],{},[47,553,554],{},[50,555,556,558,560],{},[53,557,55],{},[53,559,58],{},[53,561,61],{},[63,563,564,578,594,616,628],{},[50,565,566,572,574],{},[68,567,568,73,570],{},[30,569,72],{},[30,571,76],{},[68,573,79],{},[68,575,82,576,85],{},[30,577,76],{},[50,579,580,585,587],{},[68,581,582],{},[30,583,584],{},"reason",[68,586,95],{},[68,588,589,590,104],{},"Filter by ledger reason code (see ",[100,591,593],{"href":592},"#ledger-reason-code","Ledger reason",[50,595,596,601,603],{},[68,597,598],{},[30,599,600],{},"reference_type",[68,602,95],{},[68,604,605,606,609,610,609,613,104],{},"Filter by reference type (e.g. ",[30,607,608],{},"Card",", ",[30,611,612],{},"Ticket",[30,614,615],{},"Subscription",[50,617,618,623,625],{},[68,619,620],{},[30,621,622],{},"reference_uuid",[68,624,149],{},[68,626,627],{},"Filter by reference UUID",[50,629,630,638,640],{},[68,631,632,73,635],{},[30,633,634],{},"from",[30,636,637],{},"to",[68,639,219],{},[68,641,642],{},"Time window (ISO 8601)",[14,644,645,126],{},[18,646,647],{},"Each ledger row",[44,649,650,660],{},[47,651,652],{},[50,653,654,656,658],{},[53,655,135],{},[53,657,58],{},[53,659,140],{},[63,661,662,673,685,699,724,741,757,768,781,796,807,818],{},[50,663,664,669,671],{},[68,665,666],{},[30,667,668],{},"id",[68,670,79],{},[68,672],{},[50,674,675,680,682],{},[68,676,677],{},[30,678,679],{},"txn_group_id",[68,681,95],{},[68,683,684],{},"Groups the double-entry pair",[50,686,687,692,694],{},[68,688,689],{},[30,690,691],{},"reason_code",[68,693,95],{},[68,695,696,697],{},"Ledger reason — see ",[100,698,593],{"href":592},[50,700,701,706,710],{},[68,702,703],{},[30,704,705],{},"direction",[68,707,708],{},[18,709,79],{},[68,711,712,715,716,719,720,723],{},[30,713,714],{},"1"," = Debit, ",[30,717,718],{},"2"," = Credit (",[18,721,722],{},"integer",", not a string)",[50,725,726,731,733],{},[68,727,728],{},[30,729,730],{},"direction_label",[68,732,95],{},[68,734,735,73,738],{},[30,736,737],{},"\"Debit\"",[30,739,740],{},"\"Credit\"",[50,742,743,750,752],{},[68,744,745,73,748],{},[30,746,747],{},"amount",[30,749,205],{},[68,751,95],{},[68,753,754,755],{},"Amount is always positive; side given by ",[30,756,705],{},[50,758,759,764,766],{},[68,760,761],{},[30,762,763],{},"account_code",[68,765,188],{},[68,767],{},[50,769,770,775,778],{},[68,771,772],{},[30,773,774],{},"account_card_uuid",[68,776,777],{},"uuid?",[68,779,780],{},"UUID of the related card, if any",[50,782,783,787,789],{},[68,784,785],{},[30,786,600],{},[68,788,188],{},[68,790,791,792,609,794,104],{},"Type of the related object (e.g. ",[30,793,608],{},[30,795,612],{},[50,797,798,802,804],{},[68,799,800],{},[30,801,622],{},[68,803,777],{},[68,805,806],{},"UUID of the related object — use to deep-link to card detail, ticket, etc.",[50,808,809,814,816],{},[68,810,811],{},[30,812,813],{},"description",[68,815,188],{},[68,817],{},[50,819,820,824,826],{},[68,821,822],{},[30,823,216],{},[68,825,219],{},[68,827],{},[829,830,831],"blockquote",{},[14,832,833,834,836,837,839,840,842,843,845,846,848],{},"⚠️ ",[30,835,705],{}," is returned as an ",[18,838,722],{}," (",[30,841,714],{},"\u002F",[30,844,718],{},"), not a snake_case string. This is the one exception to the general convention. Always check ",[30,847,730],{}," for a human-readable label.",[23,850],{},[26,852,854],{"id":853},"enum-reference","Enum reference",[856,857,103],"h3",{"id":858},"order-status",[44,860,861,871],{},[47,862,863],{},[50,864,865,868],{},[53,866,867],{},"Value",[53,869,870],{},"Meaning",[63,872,873,883,893,903,912],{},[50,874,875,880],{},[68,876,877],{},[30,878,879],{},"pending",[68,881,882],{},"Created, not yet processing",[50,884,885,890],{},[68,886,887],{},[30,888,889],{},"processing",[68,891,892],{},"Processing with the supplier",[50,894,895,900],{},[68,896,897],{},[30,898,899],{},"awaiting_platform",[68,901,902],{},"Awaiting platform intervention (admin retry \u002F async fallback)",[50,904,905,909],{},[68,906,907],{},[30,908,260],{},[68,910,911],{},"Completed (terminal ✓)",[50,913,914,918],{},[68,915,916],{},[30,917,264],{},[68,919,920],{},"Failed (terminal ✗)",[856,922,120],{"id":923},"order-type",[44,925,926,934],{},[47,927,928],{},[50,929,930,932],{},[53,931,867],{},[53,933,870],{},[63,935,936,946,956,966,976],{},[50,937,938,943],{},[68,939,940],{},[30,941,942],{},"issue_card",[68,944,945],{},"Issue a card",[50,947,948,953],{},[68,949,950],{},[30,951,952],{},"topup_card",[68,954,955],{},"Top up a card",[50,957,958,963],{},[68,959,960],{},[30,961,962],{},"close_card",[68,964,965],{},"Close a card",[50,967,968,973],{},[68,969,970],{},[30,971,972],{},"freeze",[68,974,975],{},"Freeze a card",[50,977,978,983],{},[68,979,980],{},[30,981,982],{},"unfreeze",[68,984,985],{},"Unfreeze a card",[856,987,989],{"id":988},"order-failure-reason","Order failure reason",[829,991,992],{},[14,993,994,995,73,998,1001],{},"⚠️ These API strings differ slightly from internal storage — the API returns ",[30,996,997],{},"supplier5xx",[30,999,1000],{},"business4xx"," (no underscore before the digits).",[44,1003,1004,1012],{},[47,1005,1006],{},[50,1007,1008,1010],{},[53,1009,867],{},[53,1011,870],{},[63,1013,1014,1023,1033,1043,1053,1062,1072,1082,1092],{},[50,1015,1016,1020],{},[68,1017,1018],{},[30,1019,997],{},[68,1021,1022],{},"Supplier returned a 5xx (transient; auto-retried)",[50,1024,1025,1030],{},[68,1026,1027],{},[30,1028,1029],{},"timeout",[68,1031,1032],{},"Request timed out (transient; auto-retried)",[50,1034,1035,1040],{},[68,1036,1037],{},[30,1038,1039],{},"network",[68,1041,1042],{},"Network error (transient; auto-retried)",[50,1044,1045,1050],{},[68,1046,1047],{},[30,1048,1049],{},"signature",[68,1051,1052],{},"Signature verification issue (transient; auto-retried)",[50,1054,1055,1059],{},[68,1056,1057],{},[30,1058,1000],{},[68,1060,1061],{},"Supplier business rejection (terminal; needs admin)",[50,1063,1064,1069],{},[68,1065,1066],{},[30,1067,1068],{},"not_found",[68,1070,1071],{},"Supplier reports not found (terminal; needs admin)",[50,1073,1074,1079],{},[68,1075,1076],{},[30,1077,1078],{},"preempted_by_risk",[68,1080,1081],{},"Preempted by the risk engine",[50,1083,1084,1089],{},[68,1085,1086],{},[30,1087,1088],{},"admin_refund_close",[68,1090,1091],{},"Admin refund-closed the order",[50,1093,1094,1099],{},[68,1095,1096],{},[30,1097,1098],{},"async_issue_failed",[68,1100,1101],{},"Asynchronous issuance failed",[856,1103,1105],{"id":1104},"ledger-reason-code","Ledger reason code",[44,1107,1108,1116],{},[47,1109,1110],{},[50,1111,1112,1114],{},[53,1113,867],{},[53,1115,870],{},[63,1117,1118,1128,1138,1148,1158,1168,1178,1188,1198,1208,1218,1228,1238,1248,1258,1268,1278,1288,1298,1308,1318,1328,1338],{},[50,1119,1120,1125],{},[68,1121,1122],{},[30,1123,1124],{},"card_issue_held",[68,1126,1127],{},"First top-up at issuance — funds parked in held",[50,1129,1130,1135],{},[68,1131,1132],{},[30,1133,1134],{},"card_topup_held",[68,1136,1137],{},"Subsequent top-up — funds parked in held",[50,1139,1140,1145],{},[68,1141,1142],{},[30,1143,1144],{},"held_capture",[68,1146,1147],{},"Held → final destination (card held + platform revenue)",[50,1149,1150,1155],{},[68,1151,1152],{},[30,1153,1154],{},"held_release",[68,1156,1157],{},"Held → workspace balance (supplier failed)",[50,1159,1160,1165],{},[68,1161,1162],{},[30,1163,1164],{},"held_release_admin",[68,1166,1167],{},"Held → workspace balance via admin queue",[50,1169,1170,1175],{},[68,1171,1172],{},[30,1173,1174],{},"card_issue_fee",[68,1176,1177],{},"Card-issue fee → platform revenue",[50,1179,1180,1185],{},[68,1181,1182],{},[30,1183,1184],{},"card_topup_fee",[68,1186,1187],{},"Card top-up fee → platform revenue",[50,1189,1190,1195],{},[68,1191,1192],{},[30,1193,1194],{},"card_close_refund",[68,1196,1197],{},"Card closure: card held → workspace balance",[50,1199,1200,1205],{},[68,1201,1202],{},[30,1203,1204],{},"usdt_deposit",[68,1206,1207],{},"USDT deposit → workspace balance",[50,1209,1210,1215],{},[68,1211,1212],{},[30,1213,1214],{},"usdt_deposit_fee",[68,1216,1217],{},"USDT inflow channel fee → platform revenue",[50,1219,1220,1225],{},[68,1221,1222],{},[30,1223,1224],{},"withdrawal_held",[68,1226,1227],{},"Withdrawal hold: balance → held",[50,1229,1230,1235],{},[68,1231,1232],{},[30,1233,1234],{},"withdrawal_completed",[68,1236,1237],{},"Withdrawal paid out: held → pool + revenue",[50,1239,1240,1245],{},[68,1241,1242],{},[30,1243,1244],{},"withdrawal_canceled",[68,1246,1247],{},"Owner cancelled withdrawal: held → balance",[50,1249,1250,1255],{},[68,1251,1252],{},[30,1253,1254],{},"withdrawal_rejected",[68,1256,1257],{},"Admin rejected withdrawal: held → balance",[50,1259,1260,1265],{},[68,1261,1262],{},[30,1263,1264],{},"card_spend",[68,1266,1267],{},"Card spend settled — held → platform (card debit leg)",[50,1269,1270,1275],{},[68,1271,1272],{},[30,1273,1274],{},"card_spend_refund",[68,1276,1277],{},"Card spend refund — platform → workspace",[50,1279,1280,1285],{},[68,1281,1282],{},[30,1283,1284],{},"card_spend_reversal",[68,1286,1287],{},"Card spend reversal — platform → workspace",[50,1289,1290,1295],{},[68,1291,1292],{},[30,1293,1294],{},"card_post_close_clawback",[68,1296,1297],{},"Post-close clawback — workspace → platform (late charge after card closed)",[50,1299,1300,1305],{},[68,1301,1302],{},[30,1303,1304],{},"card_post_close_refund",[68,1306,1307],{},"Post-close refund — platform → workspace",[50,1309,1310,1315],{},[68,1311,1312],{},[30,1313,1314],{},"card_reconcile_adjustment",[68,1316,1317],{},"Manual reconciliation adjustment (admin only)",[50,1319,1320,1325],{},[68,1321,1322],{},[30,1323,1324],{},"subscription_charge",[68,1326,1327],{},"Subscription charge → platform revenue",[50,1329,1330,1335],{},[68,1331,1332],{},[30,1333,1334],{},"risk_penalty",[68,1336,1337],{},"Risk-engine penalty fee per declined transaction (may push wallet negative)",[50,1339,1340,1345],{},[68,1341,1342],{},[30,1343,1344],{},"reversal",[68,1346,1347],{},"Reversal \u002F red-letter correction (admin only)",[856,1349,1351],{"id":1350},"ledger-direction","Ledger direction",[44,1353,1354,1369],{},[47,1355,1356],{},[50,1357,1358,1363,1367],{},[53,1359,1360,1362],{},[30,1361,705],{}," (int)",[53,1364,1365],{},[30,1366,730],{},[53,1368,870],{},[63,1370,1371,1384],{},[50,1372,1373,1377,1381],{},[68,1374,1375],{},[30,1376,714],{},[68,1378,1379],{},[30,1380,737],{},[68,1382,1383],{},"Debit side (+Asset \u002F +Expense)",[50,1385,1386,1390,1394],{},[68,1387,1388],{},[30,1389,718],{},[68,1391,1392],{},[30,1393,740],{},[68,1395,1396],{},"Credit side (−Asset \u002F −Expense)",[23,1398],{},[26,1400,1402],{"id":1401},"schema-order","Schema: Order",[44,1404,1405,1415],{},[47,1406,1407],{},[50,1408,1409,1411,1413],{},[53,1410,135],{},[53,1412,58],{},[53,1414,140],{},[63,1416,1417,1428,1440,1452,1463,1477,1491],{},[50,1418,1419,1423,1425],{},[68,1420,1421],{},[30,1422,149],{},[68,1424,149],{},[68,1426,1427],{},"Order identifier",[50,1429,1430,1434,1436],{},[68,1431,1432],{},[30,1433,111],{},[68,1435,95],{},[68,1437,164,1438],{},[100,1439,120],{"href":119},[50,1441,1442,1446,1448],{},[68,1443,1444],{},[30,1445,92],{},[68,1447,95],{},[68,1449,164,1450],{},[100,1451,103],{"href":102},[50,1453,1454,1459,1461],{},[68,1455,1456],{},[30,1457,1458],{},"related_card_uuid",[68,1460,777],{},[68,1462,780],{},[50,1464,1465,1469,1471],{},[68,1466,1467],{},[30,1468,202],{},[68,1470,95],{},[68,1472,1473,1474],{},"Held amount, e.g. ",[30,1475,1476],{},"\"106.00\"",[50,1478,1479,1483,1485],{},[68,1480,1481],{},[30,1482,205],{},[68,1484,95],{},[68,1486,1487,1488],{},"e.g. ",[30,1489,1490],{},"\"USD\"",[50,1492,1493,1497,1499],{},[68,1494,1495],{},[30,1496,216],{},[68,1498,219],{},[68,1500],{},[1502,1503,1504],"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 .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}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);}",{"title":295,"searchDepth":309,"depth":309,"links":1506},[1507,1509,1511,1513,1515,1522],{"id":28,"depth":309,"text":1508},"GET \u002Forders — list orders",{"id":226,"depth":309,"text":1510},"GET \u002Forders\u002F{uuid} — get one order",{"id":270,"depth":309,"text":1512},"GET \u002Fwallet — wallet balance",{"id":538,"depth":309,"text":1514},"GET \u002Ftransactions — wallet ledger",{"id":853,"depth":309,"text":854,"children":1516},[1517,1518,1519,1520,1521],{"id":858,"depth":327,"text":103},{"id":923,"depth":327,"text":120},{"id":988,"depth":327,"text":989},{"id":1104,"depth":327,"text":1105},{"id":1350,"depth":327,"text":1351},{"id":1401,"depth":309,"text":1402},"api","Read orders and poll async results, query wallet balance snapshots, and retrieve full ledger transaction history.","md",{},true,"\u002Fapi\u002Forders-wallet",{"title":5,"description":1524},"api\u002F05.orders-wallet","psa3dnauBeMFJQc_XYntFC4vsKnyCrV4slc3qEtWpGs",[1533,2243,2525,3083,5052,6269,6782,7402,7790,8293],{"id":1534,"title":1535,"body":1536,"category":1523,"description":2237,"extension":1525,"meta":2238,"navigation":1527,"order":302,"path":2239,"seo":2240,"stem":2241,"__hash__":2242},"content_en\u002Fapi\u002F01.overview.md","Developer API Overview",{"type":7,"value":1537,"toc":2226},[1538,1541,1574,1576,1580,1636,1640,1658,1660,1664,1749,1894,1896,1900,1907,1919,1925,2026,2034,2036,2040,2047,2197,2214,2223],[10,1539,1535],{"id":1540},"developer-api-overview",[829,1542,1543,1558],{},[14,1544,1545,1546,1553,1554,1557],{},"This document is for ",[18,1547,1548,1549,1552],{},"developers of workspaces subscribed to the ",[30,1550,1551],{},"DEVELOPER"," product",". It describes the outward-facing, server-to-server API called with a ",[18,1555,1556],{},"workspace API token"," — a different API from the internal SPA endpoints that power the Dotva Vue front-end.",[14,1559,1560,39,1563,1566,1567,1570,1571,265],{},[18,1561,1562],{},"Source of truth",[30,1564,1565],{},"resources\u002Fopenapi\u002Fv1.yaml"," (OpenAPI 3.1). Interactive docs: ",[30,1568,1569],{},"GET \u002Fapi\u002Fv1\u002Fdocs"," (Swagger UI); raw spec at ",[30,1572,1573],{},"GET \u002Fapi\u002Fv1\u002Fopenapi.yaml",[23,1575],{},[26,1577,1579],{"id":1578},"what-this-api-is","What this API is",[1581,1582,1583,1590,1598,1612,1626],"ul",{},[1584,1585,1586,1589],"li",{},[18,1587,1588],{},"Purpose",": programmatically manage virtual cards and read orders \u002F wallet \u002F transactions.",[1584,1591,1592,39,1595],{},[18,1593,1594],{},"Base URL",[30,1596,1597],{},"\u002Fapi\u002Fv1",[1584,1599,1600,1603,1604,1607,1608,1611],{},[18,1601,1602],{},"Authentication",": every request carries ",[30,1605,1606],{},"Authorization: Bearer \u003Ctoken>",", where the token looks like ",[30,1609,1610],{},"dotva_sk_..."," and is created in the workspace's \"Developer Settings\" page.",[1584,1613,1614,1617,1618,1621,1622,1625],{},[18,1615,1616],{},"Writes are asynchronous",": any operation that moves money or changes card state returns ",[30,1619,1620],{},"202 Accepted"," plus an ",[18,1623,1624],{},"Order",", which you then poll until terminal.",[1584,1627,1628,1631,1632,1635],{},[18,1629,1630],{},"Rate limiting + idempotency",": every token and every IP has a per-minute ceiling; all write endpoints support ",[30,1633,1634],{},"X-Idempotency-Key"," for safe retries.",[856,1637,1639],{"id":1638},"prerequisites","Prerequisites",[1641,1642,1643,1649,1655],"ol",{},[1584,1644,1645,1646,1648],{},"The workspace must subscribe to the ",[30,1647,1551],{}," product (otherwise it cannot create API tokens).",[1584,1650,1651,1652,265],{},"At least one token must be created in \"Developer Settings\" and granted the required ",[18,1653,1654],{},"abilities",[1584,1656,1657],{},"If the token has an IP allowlist, the calling IP must be within it.",[23,1659],{},[26,1661,1663],{"id":1662},"quick-start","Quick start",[290,1665,1669],{"className":1666,"code":1667,"language":1668,"meta":295,"style":295},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","# 1) Validate the token; see the bound workspace and granted abilities.\ncurl -s https:\u002F\u002Fdotva.io\u002Fapi\u002Fv1\u002Fping \\\n  -H \"Authorization: Bearer dotva_sk_xxx\"\n\n# Response\n# {\n#   \"data\": {\n#     \"workspace_slug\": \"acme\",\n#     \"workspace_name\": \"Acme Inc.\",\n#     \"abilities\": [\"cards.read\", \"cards.write\", \"wallet.read\"]\n#   }\n# }\n","bash",[30,1670,1671,1677,1692,1704,1709,1714,1719,1724,1729,1734,1739,1744],{"__ignoreMap":295},[299,1672,1673],{"class":301,"line":302},[299,1674,1676],{"class":1675},"sHwdD","# 1) Validate the token; see the bound workspace and granted abilities.\n",[299,1678,1679,1682,1685,1688],{"class":301,"line":309},[299,1680,1681],{"class":333},"curl",[299,1683,1684],{"class":384}," -s",[299,1686,1687],{"class":384}," https:\u002F\u002Fdotva.io\u002Fapi\u002Fv1\u002Fping",[299,1689,1691],{"class":1690},"sTEyZ"," \\\n",[299,1693,1694,1697,1699,1702],{"class":301,"line":327},[299,1695,1696],{"class":384},"  -H",[299,1698,381],{"class":305},[299,1700,1701],{"class":384},"Authorization: Bearer dotva_sk_xxx",[299,1703,501],{"class":305},[299,1705,1706],{"class":301,"line":348},[299,1707,1708],{"emptyLinePlaceholder":1527},"\n",[299,1710,1711],{"class":301,"line":363},[299,1712,1713],{"class":1675},"# Response\n",[299,1715,1716],{"class":301,"line":369},[299,1717,1718],{"class":1675},"# {\n",[299,1720,1721],{"class":301,"line":392},[299,1722,1723],{"class":1675},"#   \"data\": {\n",[299,1725,1726],{"class":301,"line":413},[299,1727,1728],{"class":1675},"#     \"workspace_slug\": \"acme\",\n",[299,1730,1731],{"class":301,"line":434},[299,1732,1733],{"class":1675},"#     \"workspace_name\": \"Acme Inc.\",\n",[299,1735,1736],{"class":301,"line":455},[299,1737,1738],{"class":1675},"#     \"abilities\": [\"cards.read\", \"cards.write\", \"wallet.read\"]\n",[299,1740,1741],{"class":301,"line":470},[299,1742,1743],{"class":1675},"#   }\n",[299,1745,1746],{"class":301,"line":484},[299,1747,1748],{"class":1675},"# }\n",[290,1750,1752],{"className":1666,"code":1751,"language":1668,"meta":295,"style":295},"# 2) Issue a card (asynchronous; returns 202 + Order).\ncurl -s -X POST https:\u002F\u002Fdotva.io\u002Fapi\u002Fv1\u002Fcards \\\n  -H \"Authorization: Bearer dotva_sk_xxx\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-Idempotency-Key: order-2026-0001\" \\\n  -d '{\n        \"card_product_id\": 1,\n        \"initial_topup_amount\": \"100.00\",\n        \"cardholder_first_name\": \"Jane\",\n        \"cardholder_last_name\": \"Doe\"\n      }'\n\n# 3) Poll the Order until status becomes terminal (completed \u002F failed).\ncurl -s https:\u002F\u002Fdotva.io\u002Fapi\u002Fv1\u002Forders\u002F\u003Corder_uuid> \\\n  -H \"Authorization: Bearer dotva_sk_xxx\"\n",[30,1753,1754,1759,1776,1788,1801,1814,1824,1829,1834,1839,1844,1852,1856,1861,1884],{"__ignoreMap":295},[299,1755,1756],{"class":301,"line":302},[299,1757,1758],{"class":1675},"# 2) Issue a card (asynchronous; returns 202 + Order).\n",[299,1760,1761,1763,1765,1768,1771,1774],{"class":301,"line":309},[299,1762,1681],{"class":333},[299,1764,1684],{"class":384},[299,1766,1767],{"class":384}," -X",[299,1769,1770],{"class":384}," POST",[299,1772,1773],{"class":384}," https:\u002F\u002Fdotva.io\u002Fapi\u002Fv1\u002Fcards",[299,1775,1691],{"class":1690},[299,1777,1778,1780,1782,1784,1786],{"class":301,"line":327},[299,1779,1696],{"class":384},[299,1781,381],{"class":305},[299,1783,1701],{"class":384},[299,1785,319],{"class":305},[299,1787,1691],{"class":1690},[299,1789,1790,1792,1794,1797,1799],{"class":301,"line":348},[299,1791,1696],{"class":384},[299,1793,381],{"class":305},[299,1795,1796],{"class":384},"Content-Type: application\u002Fjson",[299,1798,319],{"class":305},[299,1800,1691],{"class":1690},[299,1802,1803,1805,1807,1810,1812],{"class":301,"line":363},[299,1804,1696],{"class":384},[299,1806,381],{"class":305},[299,1808,1809],{"class":384},"X-Idempotency-Key: order-2026-0001",[299,1811,319],{"class":305},[299,1813,1691],{"class":1690},[299,1815,1816,1819,1822],{"class":301,"line":369},[299,1817,1818],{"class":384},"  -d",[299,1820,1821],{"class":305}," '",[299,1823,306],{"class":384},[299,1825,1826],{"class":301,"line":392},[299,1827,1828],{"class":384},"        \"card_product_id\": 1,\n",[299,1830,1831],{"class":301,"line":413},[299,1832,1833],{"class":384},"        \"initial_topup_amount\": \"100.00\",\n",[299,1835,1836],{"class":301,"line":434},[299,1837,1838],{"class":384},"        \"cardholder_first_name\": \"Jane\",\n",[299,1840,1841],{"class":301,"line":455},[299,1842,1843],{"class":384},"        \"cardholder_last_name\": \"Doe\"\n",[299,1845,1846,1849],{"class":301,"line":470},[299,1847,1848],{"class":384},"      }",[299,1850,1851],{"class":305},"'\n",[299,1853,1854],{"class":301,"line":484},[299,1855,1708],{"emptyLinePlaceholder":1527},[299,1857,1858],{"class":301,"line":504},[299,1859,1860],{"class":1675},"# 3) Poll the Order until status becomes terminal (completed \u002F failed).\n",[299,1862,1863,1865,1867,1870,1873,1876,1879,1882],{"class":301,"line":510},[299,1864,1681],{"class":333},[299,1866,1684],{"class":384},[299,1868,1869],{"class":384}," https:\u002F\u002Fdotva.io\u002Fapi\u002Fv1\u002Forders\u002F",[299,1871,1872],{"class":305},"\u003C",[299,1874,1875],{"class":384},"order_uui",[299,1877,1878],{"class":1690},"d",[299,1880,1881],{"class":305},">",[299,1883,1691],{"class":1690},[299,1885,1886,1888,1890,1892],{"class":301,"line":516},[299,1887,1696],{"class":384},[299,1889,381],{"class":305},[299,1891,1701],{"class":384},[299,1893,501],{"class":305},[23,1895],{},[26,1897,1899],{"id":1898},"system","System",[856,1901,1903,1906],{"id":1902},"get-ping-health-token-probe",[30,1904,1905],{},"GET \u002Fping"," — health \u002F token probe",[1581,1908,1909,1914],{},[1584,1910,1911,1913],{},[18,1912,38],{},": none (any valid token)",[1584,1915,1916,1918],{},[18,1917,1588],{},": validate the token and return the bound workspace and granted abilities.",[14,1920,1921],{},[18,1922,286,1923],{},[30,1924,244],{},[290,1926,1928],{"className":292,"code":1927,"language":294,"meta":295,"style":295},"{\n  \"data\": {\n    \"workspace_slug\": \"acme\",\n    \"workspace_name\": \"Acme Inc.\",\n    \"abilities\": [\"cards.read\", \"wallet.read\"]\n  }\n}\n",[30,1929,1930,1934,1946,1966,1986,2018,2022],{"__ignoreMap":295},[299,1931,1932],{"class":301,"line":302},[299,1933,306],{"class":305},[299,1935,1936,1938,1940,1942,1944],{"class":301,"line":309},[299,1937,312],{"class":305},[299,1939,316],{"class":315},[299,1941,319],{"class":305},[299,1943,126],{"class":305},[299,1945,324],{"class":305},[299,1947,1948,1950,1953,1955,1957,1959,1962,1964],{"class":301,"line":327},[299,1949,330],{"class":305},[299,1951,1952],{"class":333},"workspace_slug",[299,1954,319],{"class":305},[299,1956,126],{"class":305},[299,1958,381],{"class":305},[299,1960,1961],{"class":384},"acme",[299,1963,319],{"class":305},[299,1965,345],{"class":305},[299,1967,1968,1970,1973,1975,1977,1979,1982,1984],{"class":301,"line":348},[299,1969,330],{"class":305},[299,1971,1972],{"class":333},"workspace_name",[299,1974,319],{"class":305},[299,1976,126],{"class":305},[299,1978,381],{"class":305},[299,1980,1981],{"class":384},"Acme Inc.",[299,1983,319],{"class":305},[299,1985,345],{"class":305},[299,1987,1988,1990,1992,1994,1996,1999,2001,2004,2006,2009,2011,2013,2015],{"class":301,"line":363},[299,1989,330],{"class":305},[299,1991,1654],{"class":333},[299,1993,319],{"class":305},[299,1995,126],{"class":305},[299,1997,1998],{"class":305}," [",[299,2000,319],{"class":305},[299,2002,2003],{"class":384},"cards.read",[299,2005,319],{"class":305},[299,2007,2008],{"class":305},",",[299,2010,381],{"class":305},[299,2012,281],{"class":384},[299,2014,319],{"class":305},[299,2016,2017],{"class":305},"]\n",[299,2019,2020],{"class":301,"line":369},[299,2021,519],{"class":305},[299,2023,2024],{"class":301,"line":392},[299,2025,525],{"class":305},[14,2027,2028,39,2031],{},[18,2029,2030],{},"Errors",[30,2032,2033],{},"401 api.unauthenticated",[23,2035],{},[26,2037,2039],{"id":2038},"async-write-model","Async write model",[14,2041,2042,2043,1621,2045,126],{},"Write endpoints return ",[30,2044,1620],{},[18,2046,1624],{},[290,2048,2050],{"className":292,"code":2049,"language":294,"meta":295,"style":295},"{\n  \"data\": {\n    \"uuid\": \"8f1c...\",\n    \"type\": \"issue_card\",\n    \"status\": \"pending\",\n    \"related_card_id\": null,\n    \"held_amount\": \"106.00\",\n    \"currency\": \"USD\",\n    \"created_at\": \"2026-06-08T01:00:00+00:00\"\n  }\n}\n",[30,2051,2052,2056,2068,2087,2105,2123,2136,2154,2172,2189,2193],{"__ignoreMap":295},[299,2053,2054],{"class":301,"line":302},[299,2055,306],{"class":305},[299,2057,2058,2060,2062,2064,2066],{"class":301,"line":309},[299,2059,312],{"class":305},[299,2061,316],{"class":315},[299,2063,319],{"class":305},[299,2065,126],{"class":305},[299,2067,324],{"class":305},[299,2069,2070,2072,2074,2076,2078,2080,2083,2085],{"class":301,"line":327},[299,2071,330],{"class":305},[299,2073,149],{"class":333},[299,2075,319],{"class":305},[299,2077,126],{"class":305},[299,2079,381],{"class":305},[299,2081,2082],{"class":384},"8f1c...",[299,2084,319],{"class":305},[299,2086,345],{"class":305},[299,2088,2089,2091,2093,2095,2097,2099,2101,2103],{"class":301,"line":348},[299,2090,330],{"class":305},[299,2092,111],{"class":333},[299,2094,319],{"class":305},[299,2096,126],{"class":305},[299,2098,381],{"class":305},[299,2100,942],{"class":384},[299,2102,319],{"class":305},[299,2104,345],{"class":305},[299,2106,2107,2109,2111,2113,2115,2117,2119,2121],{"class":301,"line":363},[299,2108,330],{"class":305},[299,2110,92],{"class":333},[299,2112,319],{"class":305},[299,2114,126],{"class":305},[299,2116,381],{"class":305},[299,2118,879],{"class":384},[299,2120,319],{"class":305},[299,2122,345],{"class":305},[299,2124,2125,2127,2130,2132,2134],{"class":301,"line":369},[299,2126,330],{"class":305},[299,2128,2129],{"class":333},"related_card_id",[299,2131,319],{"class":305},[299,2133,126],{"class":305},[299,2135,467],{"class":305},[299,2137,2138,2140,2142,2144,2146,2148,2150,2152],{"class":301,"line":392},[299,2139,330],{"class":305},[299,2141,202],{"class":333},[299,2143,319],{"class":305},[299,2145,126],{"class":305},[299,2147,381],{"class":305},[299,2149,427],{"class":384},[299,2151,319],{"class":305},[299,2153,345],{"class":305},[299,2155,2156,2158,2160,2162,2164,2166,2168,2170],{"class":301,"line":413},[299,2157,330],{"class":305},[299,2159,205],{"class":333},[299,2161,319],{"class":305},[299,2163,126],{"class":305},[299,2165,381],{"class":305},[299,2167,385],{"class":384},[299,2169,319],{"class":305},[299,2171,345],{"class":305},[299,2173,2174,2176,2178,2180,2182,2184,2187],{"class":301,"line":434},[299,2175,330],{"class":305},[299,2177,216],{"class":333},[299,2179,319],{"class":305},[299,2181,126],{"class":305},[299,2183,381],{"class":305},[299,2185,2186],{"class":384},"2026-06-08T01:00:00+00:00",[299,2188,501],{"class":305},[299,2190,2191],{"class":301,"line":455},[299,2192,519],{"class":305},[299,2194,2195],{"class":301,"line":470},[299,2196,525],{"class":305},[14,2198,2199,2200,2202,2203,2205,2206,2208,2209,73,2211,2213],{},"Take the ",[30,2201,149],{}," and poll ",[30,2204,229],{}," until ",[30,2207,92],{}," reaches a terminal value (",[30,2210,260],{},[30,2212,264],{},").",[829,2215,2216],{},[14,2217,164,2218,2222],{},[100,2219,2221],{"href":2220},"\u002Fresources\u002Fapi\u002Forders-wallet","Orders & Wallet"," for the full Orders endpoint reference, including Order status and type enums.",[1502,2224,2225],{},"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 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 .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}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 .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}",{"title":295,"searchDepth":309,"depth":309,"links":2227},[2228,2231,2232,2236],{"id":1578,"depth":309,"text":1579,"children":2229},[2230],{"id":1638,"depth":327,"text":1639},{"id":1662,"depth":309,"text":1663},{"id":1898,"depth":309,"text":1899,"children":2233},[2234],{"id":1902,"depth":327,"text":2235},"GET \u002Fping — health \u002F token probe",{"id":2038,"depth":309,"text":2039},"What the server-to-server v1 API is, base URL, quick start examples, and the async write model.",{},"\u002Fapi\u002Foverview",{"title":1535,"description":2237},"api\u002F01.overview","Njf3mHDInp4IKSL-IhH_KU5yXmRZTaHc2v8X3SJ_BvM",{"id":2244,"title":2245,"body":2246,"category":1523,"description":2519,"extension":1525,"meta":2520,"navigation":1527,"order":309,"path":2521,"seo":2522,"stem":2523,"__hash__":2524},"content_en\u002Fapi\u002F02.authentication.md","API Authentication",{"type":7,"value":2247,"toc":2512},[2248,2251,2259,2261,2265,2272,2283,2290,2342,2344,2348,2353,2356,2358,2362,2368,2370,2374,2382,2474,2479,2481,2485,2506,2509],[10,2249,2245],{"id":2250},"api-authentication",[14,2252,2253,2254,2256,2257,265],{},"All requests to the server-to-server API (",[30,2255,1597],{},") must be authenticated with a ",[18,2258,1556],{},[23,2260],{},[26,2262,2264],{"id":2263},"bearer-token","Bearer token",[14,2266,2267,2268,2271],{},"Include the token in the ",[30,2269,2270],{},"Authorization"," header on every request:",[290,2273,2277],{"className":2274,"code":2275,"language":2276,"meta":295,"style":295},"language-http shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","Authorization: Bearer dotva_sk_...\n","http",[30,2278,2279],{"__ignoreMap":295},[299,2280,2281],{"class":301,"line":302},[299,2282,2275],{},[14,2284,2285,2286,2289],{},"Tokens are created per-workspace in \"Developer Settings\". Each token is bound to a ",[18,2287,2288],{},"single workspace"," — every resource is automatically scoped to that workspace.",[44,2291,2292,2301],{},[47,2293,2294],{},[50,2295,2296,2299],{},[53,2297,2298],{},"Condition",[53,2300,241],{},[63,2302,2303,2312,2322,2332],{},[50,2304,2305,2308],{},[68,2306,2307],{},"Missing \u002F invalid \u002F expired \u002F disabled token",[68,2309,2310],{},[30,2311,2033],{},[50,2313,2314,2317],{},[68,2315,2316],{},"Token belongs to a frozen \u002F deleted workspace",[68,2318,2319],{},[30,2320,2321],{},"403 api.workspace_inactive",[50,2323,2324,2327],{},[68,2325,2326],{},"Calling IP not in the token's allowlist",[68,2328,2329],{},[30,2330,2331],{},"403 api.ip_not_allowed",[50,2333,2334,2337],{},[68,2335,2336],{},"Token lacks the required ability",[68,2338,2339],{},[30,2340,2341],{},"403 api.insufficient_ability",[23,2343],{},[26,2345,2347],{"id":2346},"ip-allowlist","IP allowlist",[14,2349,2350,2351,265],{},"A token may optionally define an IP allowlist in CIDR notation. If set, any request originating from an IP outside the allowlist is rejected with ",[30,2352,2331],{},[14,2354,2355],{},"Leave the allowlist empty to allow all IPs (useful for development; tighten for production).",[23,2357],{},[26,2359,2361],{"id":2360},"workspace-state","Workspace state",[14,2363,2364,2365,2367],{},"If the token's workspace is frozen or soft-deleted, all requests return ",[30,2366,2321],{}," regardless of the token's validity or abilities.",[23,2369],{},[26,2371,2373],{"id":2372},"token-abilities","Token abilities",[14,2375,2376,2377,2379,2380,265],{},"Each token is granted a set of ",[18,2378,1654],{}," at creation time. Routes require specific abilities — a missing ability returns ",[30,2381,2341],{},[44,2383,2384,2395],{},[47,2385,2386],{},[50,2387,2388,2390,2392],{},[53,2389,38],{},[53,2391,61],{},[53,2393,2394],{},"Applicable endpoints",[63,2396,2397,2417,2433,2448,2461],{},[50,2398,2399,2403,2406],{},[68,2400,2401],{},[30,2402,2003],{},[68,2404,2405],{},"Read cards and card transactions",[68,2407,2408,609,2411,609,2414],{},[30,2409,2410],{},"GET \u002Fcards",[30,2412,2413],{},"GET \u002Fcards\u002F{uuid}",[30,2415,2416],{},"GET \u002Fcards\u002F{uuid}\u002Ftransactions",[50,2418,2419,2424,2427],{},[68,2420,2421],{},[30,2422,2423],{},"cards.write",[68,2425,2426],{},"Issue cards and run card lifecycle",[68,2428,2429,2432],{},[30,2430,2431],{},"POST \u002Fcards",", topup \u002F freeze \u002F unfreeze \u002F close",[50,2434,2435,2439,2442],{},[68,2436,2437],{},[30,2438,42],{},[68,2440,2441],{},"Read orders",[68,2443,2444,609,2446],{},[30,2445,32],{},[30,2447,229],{},[50,2449,2450,2454,2457],{},[68,2451,2452],{},[30,2453,281],{},[68,2455,2456],{},"Read wallet balances",[68,2458,2459],{},[30,2460,273],{},[50,2462,2463,2467,2470],{},[68,2464,2465],{},[30,2466,549],{},[68,2468,2469],{},"Read wallet ledger",[68,2471,2472],{},[30,2473,541],{},[829,2475,2476],{},[14,2477,2478],{},"Grant only the abilities your integration actually needs — follow the principle of least privilege.",[23,2480],{},[26,2482,2484],{"id":2483},"creating-a-token","Creating a token",[1641,2486,2487,2494,2500,2503],{},[1584,2488,2489,2490,2493],{},"Navigate to ",[18,2491,2492],{},"Developer Settings"," in your workspace.",[1584,2495,2496,2497,265],{},"Click ",[18,2498,2499],{},"New API Token",[1584,2501,2502],{},"Enter a name, select abilities, and optionally set an IP allowlist and rate limit.",[1584,2504,2505],{},"Copy the token immediately — it is shown only once.",[14,2507,2508],{},"Tokens can be rotated or revoked from the same settings page at any time.",[1502,2510,2511],{},"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);}",{"title":295,"searchDepth":309,"depth":309,"links":2513},[2514,2515,2516,2517,2518],{"id":2263,"depth":309,"text":2264},{"id":2346,"depth":309,"text":2347},{"id":2360,"depth":309,"text":2361},{"id":2372,"depth":309,"text":2373},{"id":2483,"depth":309,"text":2484},"Bearer token authentication, IP allowlist, workspace state checks, and token ability scopes for the developer API.",{},"\u002Fapi\u002Fauthentication",{"title":2245,"description":2519},"api\u002F02.authentication","P7DPsiiq1TOlKuHKb5G-uJ_n16sFDjl4fk2zPDJHA2A",{"id":2526,"title":2527,"body":2528,"category":1523,"description":3077,"extension":1525,"meta":3078,"navigation":1527,"order":327,"path":3079,"seo":3080,"stem":3081,"__hash__":3082},"content_en\u002Fapi\u002F03.conventions.md","API Conventions",{"type":7,"value":2529,"toc":3069},[2530,2533,2538,2540,2544,2588,2590,2594,2597,2642,2648,2714,2716,2720,2749,2751,2755,2758,2777,2780,2794,2805,2807,2811,2817,2884,2895,2897,2901,3066],[10,2531,2527],{"id":2532},"api-conventions",[14,2534,2535,2536,2213],{},"These conventions apply uniformly to every endpoint in the server-to-server API (",[30,2537,1597],{},[23,2539],{},[26,2541,2543],{"id":2542},"response-envelope","Response envelope",[44,2545,2546,2556],{},[47,2547,2548],{},[50,2549,2550,2553],{},[53,2551,2552],{},"Scenario",[53,2554,2555],{},"Shape",[63,2557,2558,2568,2578],{},[50,2559,2560,2563],{},[68,2561,2562],{},"Success — single resource",[68,2564,2565],{},[30,2566,2567],{},"{ \"data\": { ... } }",[50,2569,2570,2573],{},[68,2571,2572],{},"Success — paginated list",[68,2574,2575],{},[30,2576,2577],{},"{ \"data\": [ ... ], \"meta\": { ... } }",[50,2579,2580,2583],{},[68,2581,2582],{},"Failure",[68,2584,2585],{},[30,2586,2587],{},"{ \"code\": \"business_code\", \"message\": \"human-readable\", \"data\": null }",[23,2589],{},[26,2591,2593],{"id":2592},"pagination","Pagination",[14,2595,2596],{},"All list endpoints accept the following query parameters:",[44,2598,2599,2613],{},[47,2600,2601],{},[50,2602,2603,2605,2607,2610],{},[53,2604,55],{},[53,2606,58],{},[53,2608,2609],{},"Default",[53,2611,2612],{},"Bounds",[63,2614,2615,2628],{},[50,2616,2617,2621,2623,2625],{},[68,2618,2619],{},[30,2620,72],{},[68,2622,79],{},[68,2624,714],{},[68,2626,2627],{},"≥ 1",[50,2629,2630,2634,2636,2639],{},[68,2631,2632],{},[30,2633,76],{},[68,2635,79],{},[68,2637,2638],{},"25 (orders & transactions: 50)",[68,2640,2641],{},"1–100",[14,2643,2644,2647],{},[30,2645,2646],{},"meta"," shape:",[290,2649,2651],{"className":292,"code":2650,"language":294,"meta":295,"style":295},"{ \"current_page\": 1, \"last_page\": 8, \"per_page\": 25, \"total\": 192 }\n",[30,2652,2653],{"__ignoreMap":295},[299,2654,2655,2658,2660,2663,2665,2667,2670,2672,2674,2677,2679,2681,2684,2686,2688,2690,2692,2694,2697,2699,2701,2704,2706,2708,2711],{"class":301,"line":302},[299,2656,2657],{"class":305},"{",[299,2659,381],{"class":305},[299,2661,2662],{"class":315},"current_page",[299,2664,319],{"class":305},[299,2666,126],{"class":305},[299,2668,2669],{"class":341}," 1",[299,2671,2008],{"class":305},[299,2673,381],{"class":305},[299,2675,2676],{"class":315},"last_page",[299,2678,319],{"class":305},[299,2680,126],{"class":305},[299,2682,2683],{"class":341}," 8",[299,2685,2008],{"class":305},[299,2687,381],{"class":305},[299,2689,76],{"class":315},[299,2691,319],{"class":305},[299,2693,126],{"class":305},[299,2695,2696],{"class":341}," 25",[299,2698,2008],{"class":305},[299,2700,381],{"class":305},[299,2702,2703],{"class":315},"total",[299,2705,319],{"class":305},[299,2707,126],{"class":305},[299,2709,2710],{"class":341}," 192",[299,2712,2713],{"class":305}," }\n",[23,2715],{},[26,2717,2719],{"id":2718},"money-time","Money & time",[1581,2721,2722,2741],{},[1584,2723,2724,2727,2728,2730,2731,2734,2735,2737,2738,2740],{},[18,2725,2726],{},"Money",": always a decimal ",[18,2729,95],{}," (e.g. ",[30,2732,2733],{},"\"100.00\"",") paired with a ",[30,2736,205],{}," code (e.g. ",[30,2739,1490],{},"). Never use floating-point arithmetic when processing amounts.",[1584,2742,2743,2746,2747,2213],{},[18,2744,2745],{},"Time",": UTC, ISO 8601 (e.g. ",[30,2748,2186],{},[23,2750],{},[26,2752,2754],{"id":2753},"rate-limiting","Rate limiting",[14,2756,2757],{},"Two-axis throttle:",[1581,2759,2760,2771],{},[1584,2761,2762,2763,2766,2767,2770],{},"Each ",[18,2764,2765],{},"token"," has its own per-minute ceiling (",[30,2768,2769],{},"rate_limit_per_minute","), configured when the token is created.",[1584,2772,2762,2773,2776],{},[18,2774,2775],{},"IP"," has a coarser cross-token ceiling (default 600 req\u002Fmin).",[14,2778,2779],{},"Successful responses carry:",[1581,2781,2782,2788],{},[1584,2783,2784,2787],{},[30,2785,2786],{},"X-RateLimit-Limit"," — the token's per-minute ceiling",[1584,2789,2790,2793],{},[30,2791,2792],{},"X-RateLimit-Remaining"," — remaining requests in the current window",[14,2795,2796,2797,2800,2801,2804],{},"Exceeding the limit returns ",[30,2798,2799],{},"429 api.rate_limited"," with a ",[30,2802,2803],{},"Retry-After: \u003Cseconds>"," header. Back off exactly by that duration.",[23,2806],{},[26,2808,2810],{"id":2809},"idempotency","Idempotency",[14,2812,2813,2814,2816],{},"All write endpoints accept an optional ",[30,2815,1634],{}," header (≤ 200 chars).",[44,2818,2819,2828],{},[47,2820,2821],{},[50,2822,2823,2825],{},[53,2824,2552],{},[53,2826,2827],{},"Behaviour",[63,2829,2830,2838,2850,2860,2870],{},[50,2831,2832,2835],{},[68,2833,2834],{},"First request with a given key",[68,2836,2837],{},"Executes and stores the response",[50,2839,2840,2843],{},[68,2841,2842],{},"Replay: same key + same body (within 24 h)",[68,2844,2845,2846,2849],{},"Returns original result with ",[30,2847,2848],{},"Idempotent-Replayed: true","; no side effects",[50,2851,2852,2855],{},[68,2853,2854],{},"Same key + different body",[68,2856,2857],{},[30,2858,2859],{},"422 api.idempotency_key_conflict",[50,2861,2862,2865],{},[68,2863,2864],{},"Key exceeds 200 chars",[68,2866,2867],{},[30,2868,2869],{},"422 api.idempotency_key_invalid",[50,2871,2872,2878],{},[68,2873,2874,2877],{},[30,2875,2876],{},"5xx"," response",[68,2879,2880,2883],{},[18,2881,2882],{},"Not stored"," — safe to retry",[829,2885,2886],{},[14,2887,2888,2891,2892,2894],{},[18,2889,2890],{},"Strongly recommended",": send a unique ",[30,2893,1634],{}," on every write (e.g. your own order ID). This prevents double-charge or double-issue when the network retries a request.",[23,2896],{},[26,2898,2900],{"id":2899},"error-code-reference","Error code reference",[44,2902,2903,2915],{},[47,2904,2905],{},[50,2906,2907,2910,2913],{},[53,2908,2909],{},"HTTP",[53,2911,2912],{},"Code",[53,2914,870],{},[63,2916,2917,2930,2943,2955,2967,2980,2999,3013,3026,3038,3050],{},[50,2918,2919,2922,2927],{},[68,2920,2921],{},"401",[68,2923,2924],{},[30,2925,2926],{},"api.unauthenticated",[68,2928,2929],{},"Token missing \u002F invalid \u002F expired \u002F disabled",[50,2931,2932,2935,2940],{},[68,2933,2934],{},"403",[68,2936,2937],{},[30,2938,2939],{},"api.ip_not_allowed",[68,2941,2942],{},"Calling IP not in the token allowlist",[50,2944,2945,2947,2952],{},[68,2946,2934],{},[68,2948,2949],{},[30,2950,2951],{},"api.insufficient_ability",[68,2953,2954],{},"Token lacks the ability this endpoint requires",[50,2956,2957,2959,2964],{},[68,2958,2934],{},[68,2960,2961],{},[30,2962,2963],{},"api.workspace_inactive",[68,2965,2966],{},"The owning workspace is not active",[50,2968,2969,2972,2977],{},[68,2970,2971],{},"402",[68,2973,2974],{},[30,2975,2976],{},"wallet.insufficient_balance",[68,2978,2979],{},"Insufficient wallet balance (issue \u002F top-up)",[50,2981,2982,2985,2990],{},[68,2983,2984],{},"404",[68,2986,2987],{},[30,2988,2989],{},"*.not_found",[68,2991,2992,2993,609,2996,104],{},"Resource not found in this workspace (e.g. ",[30,2994,2995],{},"card.not_found",[30,2997,2998],{},"order.not_found",[50,3000,3001,3004,3010],{},[68,3002,3003],{},"409",[68,3005,3006],{},[3007,3008,3009],"em",{},"(state conflict)",[68,3011,3012],{},"The resource's current state forbids the action (e.g. double freeze)",[50,3014,3015,3018,3023],{},[68,3016,3017],{},"422",[68,3019,3020],{},[30,3021,3022],{},"api.idempotency_key_invalid",[68,3024,3025],{},"Idempotency key too long",[50,3027,3028,3030,3035],{},[68,3029,3017],{},[68,3031,3032],{},[30,3033,3034],{},"api.idempotency_key_conflict",[68,3036,3037],{},"Idempotency key reused with a different body",[50,3039,3040,3042,3047],{},[68,3041,3017],{},[68,3043,3044],{},[3007,3045,3046],{},"(validation)",[68,3048,3049],{},"Request parameters or business rules failed",[50,3051,3052,3055,3060],{},[68,3053,3054],{},"429",[68,3056,3057],{},[30,3058,3059],{},"api.rate_limited",[68,3061,3062,3063],{},"Rate limit exceeded; back off per ",[30,3064,3065],{},"Retry-After",[1502,3067,3068],{},"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 .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}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);}",{"title":295,"searchDepth":309,"depth":309,"links":3070},[3071,3072,3073,3074,3075,3076],{"id":2542,"depth":309,"text":2543},{"id":2592,"depth":309,"text":2593},{"id":2718,"depth":309,"text":2719},{"id":2753,"depth":309,"text":2754},{"id":2809,"depth":309,"text":2810},{"id":2899,"depth":309,"text":2900},"Response envelope format, pagination, money & time conventions, rate limiting, idempotency keys, and error codes.",{},"\u002Fapi\u002Fconventions",{"title":2527,"description":3077},"api\u002F03.conventions","h97j5TkcwJsG11LWUBMbplvNVCBLszQWySfFXHtr9Oo",{"id":3084,"title":3085,"body":3086,"category":1523,"description":5046,"extension":1525,"meta":5047,"navigation":1527,"order":348,"path":5048,"seo":5049,"stem":5050,"__hash__":5051},"content_en\u002Fapi\u002F04.virtual-cards.md","Virtual Cards API",{"type":7,"value":3087,"toc":5017},[3088,3091,3112,3121,3123,3130,3138,3145,3156,3406,3426,3434,3436,3442,3448,3523,3530,3670,3678,3680,3686,3704,3709,3825,3851,3856,3887,3889,3895,3901,3911,3914,4059,4061,4068,4074,4085,4098,4103,4366,4390,4396,4398,4404,4410,4437,4573,4579,4581,4588,4599,4637,4648,4650,4657,4664,4671,4681,4689,4700,4702,4704,4707,4779,4782,4812,4815,4864,4867,4943,4946],[10,3089,3085],{"id":3090},"virtual-cards-api",[829,3092,3093],{},[14,3094,3095,3096,3099,3100,1621,3102,3104,3105,73,3107,3109,3110,265],{},"All write operations are ",[18,3097,3098],{},"asynchronous"," — they return ",[30,3101,1620],{},[100,3103,1624],{"href":2220},". Poll the order until its status is terminal (",[30,3106,260],{},[30,3108,264],{},").\nAll write endpoints support ",[30,3111,1634],{},[14,3113,3114,3115,3117,3118,3120],{},"Required abilities: ",[30,3116,2003],{}," (reads) · ",[30,3119,2423],{}," (writes).",[23,3122],{},[26,3124,3126,3129],{"id":3125},"get-card-products-list-issuable-card-products",[30,3127,3128],{},"GET \u002Fcard-products"," — list issuable card products",[14,3131,3132,39,3134,261,3136],{},[18,3133,38],{},[30,3135,2003],{},[30,3137,2423],{},[14,3139,3140,3141,3144],{},"Before issuing a card you must call this endpoint to obtain a valid ",[30,3142,3143],{},"card_product_id"," and check fee\u002Flimit constraints. The catalogue is platform-global; each row is annotated for your workspace.",[14,3146,3147,3151,3152,3155],{},[18,3148,286,3149],{},[30,3150,244],{}," — ",[30,3153,3154],{},"{ \"data\": [ ... ] }"," (not paginated). Each product:",[44,3157,3158,3168],{},[47,3159,3160],{},[50,3161,3162,3164,3166],{},[53,3163,135],{},[53,3165,58],{},[53,3167,140],{},[63,3169,3170,3186,3201,3212,3227,3240,3252,3271,3283,3295,3311,3329,3341,3353,3365,3381,3393],{},[50,3171,3172,3176,3178],{},[68,3173,3174],{},[30,3175,668],{},[68,3177,79],{},[68,3179,3180,3181,3183,3184],{},"Pass as ",[30,3182,3143],{}," to ",[30,3185,2431],{},[50,3187,3188,3197,3199],{},[68,3189,3190,73,3192,73,3195],{},[30,3191,30],{},[30,3193,3194],{},"display_name",[30,3196,813],{},[68,3198,95],{},[68,3200],{},[50,3202,3203,3207,3209],{},[68,3204,3205],{},[30,3206,205],{},[68,3208,95],{},[68,3210,3211],{},"Product currency",[50,3213,3214,3222,3224],{},[68,3215,3216,73,3219],{},[30,3217,3218],{},"bin",[30,3220,3221],{},"issuer_country",[68,3223,95],{},[68,3225,3226],{},"BIN prefix and issuing country",[50,3228,3229,3234,3237],{},[68,3230,3231],{},[30,3232,3233],{},"supports_custom_holder_name",[68,3235,3236],{},"bool",[68,3238,3239],{},"Whether a custom cardholder name can be specified",[50,3241,3242,3247,3249],{},[68,3243,3244],{},[30,3245,3246],{},"supports_custom_billing_address",[68,3248,3236],{},[68,3250,3251],{},"Whether a custom billing address can be specified",[50,3253,3254,3259,3262],{},[68,3255,3256],{},[30,3257,3258],{},"default_billing_address",[68,3260,3261],{},"object?",[68,3263,3264,3265,3267,3268],{},"Used when ",[30,3266,3246],{}," is ",[30,3269,3270],{},"false",[50,3272,3273,3278,3280],{},[68,3274,3275],{},[30,3276,3277],{},"fees.card_issue_fixed",[68,3279,95],{},[68,3281,3282],{},"One-time issuance fee (decimal, deducted from initial top-up)",[50,3284,3285,3290,3292],{},[68,3286,3287],{},[30,3288,3289],{},"fees.topup_fixed",[68,3291,95],{},[68,3293,3294],{},"Fixed fee per subsequent top-up",[50,3296,3297,3302,3304],{},[68,3298,3299],{},[30,3300,3301],{},"fees.topup_percent",[68,3303,95],{},[68,3305,3306,3307,3310],{},"Percentage fee per subsequent top-up (e.g. ",[30,3308,3309],{},"\"0.0300\""," = 3 %)",[50,3312,3313,3318,3320],{},[68,3314,3315],{},[30,3316,3317],{},"min_initial_topup_amount",[68,3319,95],{},[68,3321,3322,3323,3326,3327],{},"Minimum ",[30,3324,3325],{},"initial_topup_amount"," for ",[30,3328,2431],{},[50,3330,3331,3336,3338],{},[68,3332,3333],{},[30,3334,3335],{},"min_topup_amount",[68,3337,95],{},[68,3339,3340],{},"Minimum amount for subsequent top-ups",[50,3342,3343,3348,3350],{},[68,3344,3345],{},[30,3346,3347],{},"required_subscription_product_code",[68,3349,188],{},[68,3351,3352],{},"Subscription prerequisite, if any",[50,3354,3355,3360,3362],{},[68,3356,3357],{},[30,3358,3359],{},"requires_subscription",[68,3361,3236],{},[68,3363,3364],{},"Whether a subscription prerequisite exists",[50,3366,3367,3372,3374],{},[68,3368,3369],{},[30,3370,3371],{},"subscription_satisfied",[68,3373,3236],{},[68,3375,3376,3377,3380],{},"Whether this workspace meets the prerequisite (",[30,3378,3379],{},"true"," when none)",[50,3382,3383,3388,3390],{},[68,3384,3385],{},[30,3386,3387],{},"currency_match",[68,3389,3236],{},[68,3391,3392],{},"Whether product currency equals the workspace base currency (informational)",[50,3394,3395,3399,3401],{},[68,3396,3397],{},[30,3398,439],{},[68,3400,3236],{},[68,3402,3403,3404,104],{},"Whether this workspace may issue this product (= ",[30,3405,3371],{},[829,3407,3408],{},[14,3409,3410,3413,3414,3416,3417,3419,3420,3422,3423,3425],{},[18,3411,3412],{},"Workflow",": call this endpoint to render a product picker → use the selected product's ",[30,3415,668],{}," as ",[30,3418,3143],{},", and validate the user's ",[30,3421,3325],{}," against ",[30,3424,3317],{}," client-side before submitting.",[14,3427,3428,39,3430,609,3432],{},[18,3429,2030],{},[30,3431,2921],{},[30,3433,2934],{},[23,3435],{},[26,3437,3439,3441],{"id":3438},"get-cards-list-cards",[30,3440,2410],{}," — list cards",[14,3443,3444,39,3446],{},[18,3445,38],{},[30,3447,2003],{},[44,3449,3450,3460],{},[47,3451,3452],{},[50,3453,3454,3456,3458],{},[53,3455,55],{},[53,3457,58],{},[53,3459,61],{},[63,3461,3462,3474,3489,3511],{},[50,3463,3464,3470,3472],{},[68,3465,3466,73,3468],{},[30,3467,72],{},[30,3469,76],{},[68,3471,79],{},[68,3473,2593],{},[50,3475,3476,3480,3482],{},[68,3477,3478],{},[30,3479,92],{},[68,3481,95],{},[68,3483,3484,3485,104],{},"Comma-separated card statuses (see ",[100,3486,3488],{"href":3487},"#card-status","Card status",[50,3490,3491,3496,3498],{},[68,3492,3493],{},[30,3494,3495],{},"cardholder_type",[68,3497,95],{},[68,3499,3500,261,3503,3506,3507,104],{},[30,3501,3502],{},"user",[30,3504,3505],{},"staff"," (see ",[100,3508,3510],{"href":3509},"#cardholder-type","Cardholder type",[50,3512,3513,3518,3520],{},[68,3514,3515],{},[30,3516,3517],{},"search",[68,3519,95],{},[68,3521,3522],{},"Keyword search",[14,3524,3525,3529],{},[18,3526,286,3527],{},[30,3528,244],{}," — paginated list. Each card row:",[44,3531,3532,3542],{},[47,3533,3534],{},[50,3535,3536,3538,3540],{},[53,3537,135],{},[53,3539,58],{},[53,3541,140],{},[63,3543,3544,3554,3567,3581,3595,3607,3621,3631,3643,3653],{},[50,3545,3546,3550,3552],{},[68,3547,3548],{},[30,3549,149],{},[68,3551,149],{},[68,3553],{},[50,3555,3556,3560,3562],{},[68,3557,3558],{},[30,3559,92],{},[68,3561,95],{},[68,3563,3564,3565],{},"Card status — see ",[100,3566,3488],{"href":3487},[50,3568,3569,3573,3575],{},[68,3570,3571],{},[30,3572,3495],{},[68,3574,95],{},[68,3576,3577,73,3579],{},[30,3578,3502],{},[30,3580,3505],{},[50,3582,3583,3591,3593],{},[68,3584,3585,73,3588],{},[30,3586,3587],{},"cardholder_first_name",[30,3589,3590],{},"cardholder_last_name",[68,3592,95],{},[68,3594],{},[50,3596,3597,3602,3604],{},[68,3598,3599],{},[30,3600,3601],{},"masked_pan",[68,3603,95],{},[68,3605,3606],{},"Masked card number",[50,3608,3609,3617,3619],{},[68,3610,3611,73,3614],{},[30,3612,3613],{},"pan_last4",[30,3615,3616],{},"pan_bin",[68,3618,95],{},[68,3620],{},[50,3622,3623,3627,3629],{},[68,3624,3625],{},[30,3626,205],{},[68,3628,95],{},[68,3630],{},[50,3632,3633,3638,3640],{},[68,3634,3635],{},[30,3636,3637],{},"card_balance",[68,3639,95],{},[68,3641,3642],{},"Decimal string",[50,3644,3645,3649,3651],{},[68,3646,3647],{},[30,3648,3143],{},[68,3650,79],{},[68,3652],{},[50,3654,3655,3665,3668],{},[68,3656,3657,73,3660,73,3663],{},[30,3658,3659],{},"issued_at",[30,3661,3662],{},"last_active_txn_at",[30,3664,216],{},[68,3666,3667],{},"datetime?",[68,3669],{},[14,3671,3672,39,3674,609,3676],{},[18,3673,2030],{},[30,3675,2921],{},[30,3677,2934],{},[23,3679],{},[26,3681,3683,3685],{"id":3682},"post-cards-issue-a-card",[30,3684,2431],{}," — issue a card",[14,3687,3688,39,3690,3692,3693,3696,3697,3700,3701,104],{},[18,3689,38],{},[30,3691,2423],{}," · ",[18,3694,3695],{},"Idempotent",": yes · ",[18,3698,3699],{},"Async",": yes (",[30,3702,3703],{},"202",[14,3705,3706],{},[18,3707,3708],{},"Body",[44,3710,3711,3724],{},[47,3712,3713],{},[50,3714,3715,3717,3719,3722],{},[53,3716,135],{},[53,3718,58],{},[53,3720,3721],{},"Required",[53,3723,61],{},[63,3725,3726,3740,3755,3768,3781,3797,3811],{},[50,3727,3728,3732,3734,3737],{},[68,3729,3730],{},[30,3731,3143],{},[68,3733,79],{},[68,3735,3736],{},"✓",[68,3738,3739],{},"Card product ID",[50,3741,3742,3746,3748,3750],{},[68,3743,3744],{},[30,3745,3325],{},[68,3747,95],{},[68,3749,3736],{},[68,3751,3752,3753],{},"Initial top-up amount, e.g. ",[30,3754,2733],{},[50,3756,3757,3761,3763,3765],{},[68,3758,3759],{},[30,3760,3587],{},[68,3762,95],{},[68,3764,3736],{},[68,3766,3767],{},"Cardholder first name",[50,3769,3770,3774,3776,3778],{},[68,3771,3772],{},[30,3773,3590],{},[68,3775,95],{},[68,3777,3736],{},[68,3779,3780],{},"Cardholder last name",[50,3782,3783,3788,3791,3794],{},[68,3784,3785],{},[30,3786,3787],{},"billing_address",[68,3789,3790],{},"object",[68,3792,3793],{},"—",[68,3795,3796],{},"Billing address (see below)",[50,3798,3799,3804,3806,3808],{},[68,3800,3801],{},[30,3802,3803],{},"purpose",[68,3805,95],{},[68,3807,3793],{},[68,3809,3810],{},"Purpose note",[50,3812,3813,3818,3820,3822],{},[68,3814,3815],{},[30,3816,3817],{},"notes",[68,3819,95],{},[68,3821,3793],{},[68,3823,3824],{},"Free-form notes",[14,3826,3827,3829,3830,3833,3834,3837,3838,3833,3841,3837,3844,3833,3847,3850],{},[30,3828,3787],{}," fields: ",[30,3831,3832],{},"line1"," (string), ",[30,3835,3836],{},"line2"," (string?), ",[30,3839,3840],{},"city",[30,3842,3843],{},"state",[30,3845,3846],{},"postal_code",[30,3848,3849],{},"country"," (2-letter ISO code).",[14,3852,3853,126],{},[18,3854,3855],{},"Responses",[1581,3857,3858,3872,3877],{},[1584,3859,3860,3862,3863,3866,3867,3871],{},[30,3861,3703],{}," — Order accepted. Encrypted card secrets are delivered separately via the ",[30,3864,3865],{},"card.issued.secrets"," ",[100,3868,3870],{"href":3869},"\u002Fresources\u002Fapi\u002Fwebhooks","webhook"," — they never appear in regular API responses.",[1584,3873,3874],{},[30,3875,3876],{},"402 wallet.insufficient_balance",[1584,3878,3879,609,3881,609,3883,609,3885],{},[30,3880,2921],{},[30,3882,2934],{},[30,3884,3017],{},[30,3886,3054],{},[23,3888],{},[26,3890,3892,3894],{"id":3891},"get-cardsuuid-get-one-card",[30,3893,2413],{}," — get one card",[14,3896,3897,39,3899],{},[18,3898,38],{},[30,3900,2003],{},[14,3902,3903,39,3905,3907,3908],{},[18,3904,241],{},[30,3906,244],{}," card detail \u002F ",[30,3909,3910],{},"404 card.not_found",[14,3912,3913],{},"All fields from the list response, plus:",[44,3915,3916,3926],{},[47,3917,3918],{},[50,3919,3920,3922,3924],{},[53,3921,135],{},[53,3923,58],{},[53,3925,140],{},[63,3927,3928,3938,3949,3960,3974,3992,4015,4033,4045],{},[50,3929,3930,3934,3936],{},[68,3931,3932],{},[30,3933,334],{},[68,3935,79],{},[68,3937],{},[50,3939,3940,3944,3946],{},[68,3941,3942],{},[30,3943,3637],{},[68,3945,95],{},[68,3947,3948],{},"Raw card balance",[50,3950,3951,3955,3957],{},[68,3952,3953],{},[30,3954,202],{},[68,3956,95],{},[68,3958,3959],{},"Amount held in pending authorization",[50,3961,3962,3967,3969],{},[68,3963,3964],{},[30,3965,3966],{},"available_balance",[68,3968,95],{},[68,3970,3971],{},[30,3972,3973],{},"card_balance − held_amount",[50,3975,3976,3987,3989],{},[68,3977,3978,73,3981,73,3984],{},[30,3979,3980],{},"lifetime_topup_amount",[30,3982,3983],{},"lifetime_spend_amount",[30,3985,3986],{},"lifetime_refund_amount",[68,3988,95],{},[68,3990,3991],{},"Cumulative amounts",[50,3993,3994,3999,4001],{},[68,3995,3996],{},[30,3997,3998],{},"avs_billing_address",[68,4000,3261],{},[68,4002,4003,609,4005,609,4007,609,4009,609,4011,609,4013],{},[30,4004,3832],{},[30,4006,3836],{},[30,4008,3840],{},[30,4010,3843],{},[30,4012,3846],{},[30,4014,3849],{},[50,4016,4017,4028,4030],{},[68,4018,4019,73,4022,73,4025],{},[30,4020,4021],{},"supports_freeze",[30,4023,4024],{},"supports_unfreeze",[30,4026,4027],{},"supports_balance_query",[68,4029,3236],{},[68,4031,4032],{},"Capability flags — show\u002Fhide action buttons based on these",[50,4034,4035,4040,4042],{},[68,4036,4037],{},[30,4038,4039],{},"appeal_terminated",[68,4041,3236],{},[68,4043,4044],{},"Whether appeals are permanently closed",[50,4046,4047,4055,4057],{},[68,4048,4049,73,4052],{},[30,4050,4051],{},"closed_at",[30,4053,4054],{},"updated_at",[68,4056,3667],{},[68,4058],{},[23,4060],{},[26,4062,4064,4067],{"id":4063},"get-cardsuuidconsumption-bills-consumption-bills-merged-view",[30,4065,4066],{},"GET \u002Fcards\u002F{uuid}\u002Fconsumption-bills"," — consumption bills (merged view)",[14,4069,4070,39,4072],{},[18,4071,38],{},[30,4073,2003],{},[14,4075,4076,4077,4080,4081,4084],{},"Unlike ",[30,4078,4079],{},"\u002Ftransactions"," which returns one row per network event, this endpoint returns ",[18,4082,4083],{},"one item per purchase",", merging the Authorization → Capture \u002F Refund \u002F Reversal lifecycle into a single bill. Use this for end-user transaction history displays.",[14,4086,4087,39,4089,73,4091,4093,4094,73,4096],{},[18,4088,55],{},[30,4090,634],{},[30,4092,637],{}," (datetime), ",[30,4095,72],{},[30,4097,76],{},[14,4099,4100,126],{},[18,4101,4102],{},"Each bill",[44,4104,4105,4115],{},[47,4106,4107],{},[50,4108,4109,4111,4113],{},[53,4110,135],{},[53,4112,58],{},[53,4114,140],{},[63,4116,4117,4128,4154,4188,4199,4212,4226,4242,4254,4269,4281,4303,4314,4329,4341,4353],{},[50,4118,4119,4123,4125],{},[68,4120,4121],{},[30,4122,668],{},[68,4124,79],{},[68,4126,4127],{},"Bill identifier",[50,4129,4130,4135,4137],{},[68,4131,4132],{},[30,4133,4134],{},"kind",[68,4136,95],{},[68,4138,4139,73,4142,73,4145,73,4148,73,4151],{},[30,4140,4141],{},"purchase",[30,4143,4144],{},"refund",[30,4146,4147],{},"decline",[30,4149,4150],{},"chargeback",[30,4152,4153],{},"other",[50,4155,4156,4160,4162],{},[68,4157,4158],{},[30,4159,92],{},[68,4161,95],{},[68,4163,4164,73,4167,73,4170,73,4173,73,4176,73,4179,73,4182,73,4185],{},[30,4165,4166],{},"authorized",[30,4168,4169],{},"settled",[30,4171,4172],{},"reversed",[30,4174,4175],{},"expired",[30,4177,4178],{},"declined",[30,4180,4181],{},"refunded",[30,4183,4184],{},"chargeback_opened",[30,4186,4187],{},"chargeback_resolved",[50,4189,4190,4194,4196],{},[68,4191,4192],{},[30,4193,747],{},[68,4195,95],{},[68,4197,4198],{},"Base amount",[50,4200,4201,4205,4207],{},[68,4202,4203],{},[30,4204,205],{},[68,4206,95],{},[68,4208,4209,4210,104],{},"Settlement currency (e.g. ",[30,4211,385],{},[50,4213,4214,4219,4221],{},[68,4215,4216],{},[30,4217,4218],{},"authorized_amount",[68,4220,188],{},[68,4222,4223,4224,104],{},"Amount authorized (available when status is ",[30,4225,4166],{},[50,4227,4228,4233,4235],{},[68,4229,4230],{},[30,4231,4232],{},"settled_amount",[68,4234,188],{},[68,4236,4237,4238,73,4240,104],{},"Amount settled (available when status is ",[30,4239,4169],{},[30,4241,4181],{},[50,4243,4244,4249,4251],{},[68,4245,4246],{},[30,4247,4248],{},"transaction_amount",[68,4250,188],{},[68,4252,4253],{},"Original presentment amount",[50,4255,4256,4261,4263],{},[68,4257,4258],{},[30,4259,4260],{},"transaction_currency",[68,4262,188],{},[68,4264,4265,4266,104],{},"Original presentment currency (e.g. ",[30,4267,4268],{},"HKD",[50,4270,4271,4276,4278],{},[68,4272,4273],{},[30,4274,4275],{},"fx_rate",[68,4277,188],{},[68,4279,4280],{},"FX rate applied",[50,4282,4283,4288,4290],{},[68,4284,4285],{},[30,4286,4287],{},"merchant",[68,4289,3261],{},[68,4291,4292,609,4295,609,4298,609,4301],{},[30,4293,4294],{},"raw_name",[30,4296,4297],{},"canonical_name",[30,4299,4300],{},"mcc",[30,4302,3849],{},[50,4304,4305,4310,4312],{},[68,4306,4307],{},[30,4308,4309],{},"auth_code",[68,4311,188],{},[68,4313],{},[50,4315,4316,4321,4323],{},[68,4317,4318],{},[30,4319,4320],{},"decline_reason",[68,4322,188],{},[68,4324,164,4325],{},[100,4326,4328],{"href":4327},"#decline-reason","Decline reason",[50,4330,4331,4336,4338],{},[68,4332,4333],{},[30,4334,4335],{},"occurred_at",[68,4337,219],{},[68,4339,4340],{},"Time of most recent event on this bill",[50,4342,4343,4348,4350],{},[68,4344,4345],{},[30,4346,4347],{},"settled_at",[68,4349,3667],{},[68,4351,4352],{},"Settlement time",[50,4354,4355,4360,4363],{},[68,4356,4357],{},[30,4358,4359],{},"lines",[68,4361,4362],{},"array",[68,4364,4365],{},"Raw transaction rows included in this bill",[829,4367,4368],{},[14,4369,4370,4373,4374,4376,4377,4380,4381,4383,4384,4386,4387,4389],{},[18,4371,4372],{},"Display rule",": show ",[30,4375,4218],{}," when ",[30,4378,4379],{},"status === \"authorized\"","; show ",[30,4382,4232],{}," when settled or refunded. ",[30,4385,4248],{}," + ",[30,4388,4260],{}," show the original presentment currency for cross-border transactions.",[14,4391,4392,39,4394],{},[18,4393,2030],{},[30,4395,3910],{},[23,4397],{},[26,4399,4401,4403],{"id":4400},"get-cardsuuidtransactions-card-transactions",[30,4402,2416],{}," — card transactions",[14,4405,4406,39,4408],{},[18,4407,38],{},[30,4409,2003],{},[14,4411,4412,39,4414,73,4416,4418,4419,3506,4421,4425,4426,3506,4428,4425,4432,73,4434,4436],{},[18,4413,55],{},[30,4415,72],{},[30,4417,76],{},"; optional ",[30,4420,111],{},[100,4422,4424],{"href":4423},"#transaction-type","Transaction type","), ",[30,4427,92],{},[100,4429,4431],{"href":4430},"#transaction-status","Transaction status",[30,4433,634],{},[30,4435,637],{}," (datetime).",[44,4438,4439,4449],{},[47,4440,4441],{},[50,4442,4443,4445,4447],{},[53,4444,135],{},[53,4446,58],{},[53,4448,140],{},[63,4450,4451,4461,4473,4485,4497,4514,4535,4545,4558],{},[50,4452,4453,4457,4459],{},[68,4454,4455],{},[30,4456,149],{},[68,4458,149],{},[68,4460],{},[50,4462,4463,4467,4469],{},[68,4464,4465],{},[30,4466,111],{},[68,4468,95],{},[68,4470,164,4471],{},[100,4472,4424],{"href":4423},[50,4474,4475,4479,4481],{},[68,4476,4477],{},[30,4478,92],{},[68,4480,95],{},[68,4482,164,4483],{},[100,4484,4431],{"href":4430},[50,4486,4487,4493,4495],{},[68,4488,4489,73,4491],{},[30,4490,747],{},[30,4492,205],{},[68,4494,95],{},[68,4496],{},[50,4498,4499,4509,4511],{},[68,4500,4501,73,4504,73,4507],{},[30,4502,4503],{},"fx_amount",[30,4505,4506],{},"fx_currency",[30,4508,4275],{},[68,4510,188],{},[68,4512,4513],{},"FX detail",[50,4515,4516,4520,4522],{},[68,4517,4518],{},[30,4519,4287],{},[68,4521,3790],{},[68,4523,4524,609,4526,609,4529,609,4531,609,4533],{},[30,4525,4294],{},[30,4527,4528],{},"canonical_merchant_id",[30,4530,4297],{},[30,4532,4300],{},[30,4534,3849],{},[50,4536,4537,4541,4543],{},[68,4538,4539],{},[30,4540,4309],{},[68,4542,188],{},[68,4544],{},[50,4546,4547,4551,4553],{},[68,4548,4549],{},[30,4550,4320],{},[68,4552,188],{},[68,4554,4555,4556],{},"Null unless declined — see ",[100,4557,4328],{"href":4327},[50,4559,4560,4569,4571],{},[68,4561,4562,73,4564,73,4567],{},[30,4563,4335],{},[30,4565,4566],{},"posted_at",[30,4568,216],{},[68,4570,3667],{},[68,4572],{},[14,4574,4575,39,4577],{},[18,4576,2030],{},[30,4578,3910],{},[23,4580],{},[26,4582,4584,4587],{"id":4583},"post-cardsuuidtopup-top-up-a-card",[30,4585,4586],{},"POST \u002Fcards\u002F{uuid}\u002Ftopup"," — top up a card",[14,4589,4590,39,4592,3692,4594,3696,4596,4598],{},[18,4591,38],{},[30,4593,2423],{},[18,4595,3695],{},[18,4597,3699],{},": yes",[44,4600,4601,4611],{},[47,4602,4603],{},[50,4604,4605,4607,4609],{},[53,4606,135],{},[53,4608,3721],{},[53,4610,61],{},[63,4612,4613,4627],{},[50,4614,4615,4619,4621],{},[68,4616,4617],{},[30,4618,747],{},[68,4620,3736],{},[68,4622,4623,4624],{},"Top-up amount, e.g. ",[30,4625,4626],{},"\"50.00\"",[50,4628,4629,4633,4635],{},[68,4630,4631],{},[30,4632,3817],{},[68,4634,3793],{},[68,4636,3824],{},[14,4638,4639,39,4641,4643,4644,73,4646],{},[18,4640,3855],{},[30,4642,3703],{}," Order \u002F ",[30,4645,2984],{},[30,4647,3017],{},[23,4649],{},[26,4651,4653,4656],{"id":4652},"post-cardsuuidfreeze-freeze-a-card",[30,4654,4655],{},"POST \u002Fcards\u002F{uuid}\u002Ffreeze"," — freeze a card",[26,4658,4660,4663],{"id":4659},"post-cardsuuidunfreeze-unfreeze-a-card",[30,4661,4662],{},"POST \u002Fcards\u002F{uuid}\u002Funfreeze"," — unfreeze a card",[26,4665,4667,4670],{"id":4666},"post-cardsuuidclose-close-a-card",[30,4668,4669],{},"POST \u002Fcards\u002F{uuid}\u002Fclose"," — close a card",[14,4672,4673,39,4675,3692,4677,3696,4679,4598],{},[18,4674,38],{},[30,4676,2423],{},[18,4678,3695],{},[18,4680,3699],{},[14,4682,4683,4685,4686],{},[18,4684,3708],{}," (optional): ",[30,4687,4688],{},"{ \"reason\": \"up to 500 chars, nullable\" }",[14,4690,4691,39,4693,4643,4695,73,4697,4699],{},[18,4692,3855],{},[30,4694,3703],{},[30,4696,3910],{},[30,4698,3003],{}," (state conflict, e.g. double freeze)",[23,4701],{},[26,4703,854],{"id":853},[856,4705,3488],{"id":4706},"card-status",[44,4708,4709,4717],{},[47,4710,4711],{},[50,4712,4713,4715],{},[53,4714,867],{},[53,4716,870],{},[63,4718,4719,4729,4739,4749,4759,4769],{},[50,4720,4721,4726],{},[68,4722,4723],{},[30,4724,4725],{},"pending_issue",[68,4727,4728],{},"Issuance queued, not yet active",[50,4730,4731,4736],{},[68,4732,4733],{},[30,4734,4735],{},"active",[68,4737,4738],{},"Active and usable",[50,4740,4741,4746],{},[68,4742,4743],{},[30,4744,4745],{},"frozen",[68,4747,4748],{},"Temporarily frozen",[50,4750,4751,4756],{},[68,4752,4753],{},[30,4754,4755],{},"pending_close",[68,4757,4758],{},"Closure in progress",[50,4760,4761,4766],{},[68,4762,4763],{},[30,4764,4765],{},"closed",[68,4767,4768],{},"Closed (terminal)",[50,4770,4771,4776],{},[68,4772,4773],{},[30,4774,4775],{},"issue_failed",[68,4777,4778],{},"Issuance failed (terminal)",[856,4780,3510],{"id":4781},"cardholder-type",[44,4783,4784,4792],{},[47,4785,4786],{},[50,4787,4788,4790],{},[53,4789,867],{},[53,4791,870],{},[63,4793,4794,4803],{},[50,4795,4796,4800],{},[68,4797,4798],{},[30,4799,3502],{},[68,4801,4802],{},"Held by a main-account user",[50,4804,4805,4809],{},[68,4806,4807],{},[30,4808,3505],{},[68,4810,4811],{},"Held by a staff member",[856,4813,4431],{"id":4814},"transaction-status",[44,4816,4817,4825],{},[47,4818,4819],{},[50,4820,4821,4823],{},[53,4822,867],{},[53,4824,870],{},[63,4826,4827,4836,4846,4855],{},[50,4828,4829,4833],{},[68,4830,4831],{},[30,4832,879],{},[68,4834,4835],{},"Pending",[50,4837,4838,4843],{},[68,4839,4840],{},[30,4841,4842],{},"posted",[68,4844,4845],{},"Posted \u002F settled",[50,4847,4848,4852],{},[68,4849,4850],{},[30,4851,4172],{},[68,4853,4854],{},"Reversed",[50,4856,4857,4861],{},[68,4858,4859],{},[30,4860,264],{},[68,4862,4863],{},"Failed (e.g. a decline row)",[856,4865,4424],{"id":4866},"transaction-type",[44,4868,4869,4877],{},[47,4870,4871],{},[50,4872,4873,4875],{},[53,4874,867],{},[53,4876,870],{},[63,4878,4879,4888,4898,4907,4916,4925,4934],{},[50,4880,4881,4886],{},[68,4882,4883],{},[30,4884,4885],{},"authorization",[68,4887,2270],{},[50,4889,4890,4895],{},[68,4891,4892],{},[30,4893,4894],{},"capture",[68,4896,4897],{},"Capture",[50,4899,4900,4904],{},[68,4901,4902],{},[30,4903,4144],{},[68,4905,4906],{},"Refund",[50,4908,4909,4913],{},[68,4910,4911],{},[30,4912,1344],{},[68,4914,4915],{},"Reversal",[50,4917,4918,4922],{},[68,4919,4920],{},[30,4921,4147],{},[68,4923,4924],{},"Decline",[50,4926,4927,4931],{},[68,4928,4929],{},[30,4930,4184],{},[68,4932,4933],{},"Chargeback opened",[50,4935,4936,4940],{},[68,4937,4938],{},[30,4939,4187],{},[68,4941,4942],{},"Chargeback resolved",[856,4944,4328],{"id":4945},"decline-reason",[44,4947,4948,4956],{},[47,4949,4950],{},[50,4951,4952,4954],{},[53,4953,867],{},[53,4955,870],{},[63,4957,4958,4968,4978,4988,4998,5008],{},[50,4959,4960,4965],{},[68,4961,4962],{},[30,4963,4964],{},"insufficient_funds",[68,4966,4967],{},"Insufficient funds",[50,4969,4970,4975],{},[68,4971,4972],{},[30,4973,4974],{},"card_frozen",[68,4976,4977],{},"Card frozen",[50,4979,4980,4985],{},[68,4981,4982],{},[30,4983,4984],{},"avs_mismatch",[68,4986,4987],{},"Billing-address (AVS) mismatch",[50,4989,4990,4995],{},[68,4991,4992],{},[30,4993,4994],{},"cvv_mismatch",[68,4996,4997],{},"CVV mismatch",[50,4999,5000,5005],{},[68,5001,5002],{},[30,5003,5004],{},"risk_blocked",[68,5006,5007],{},"Blocked by risk engine",[50,5009,5010,5014],{},[68,5011,5012],{},[30,5013,4153],{},[68,5015,5016],{},"Other (catch-all for unmapped vendor reasons)",{"title":295,"searchDepth":309,"depth":309,"links":5018},[5019,5021,5023,5025,5027,5029,5031,5033,5035,5037,5039],{"id":3125,"depth":309,"text":5020},"GET \u002Fcard-products — list issuable card products",{"id":3438,"depth":309,"text":5022},"GET \u002Fcards — list cards",{"id":3682,"depth":309,"text":5024},"POST \u002Fcards — issue a card",{"id":3891,"depth":309,"text":5026},"GET \u002Fcards\u002F{uuid} — get one card",{"id":4063,"depth":309,"text":5028},"GET \u002Fcards\u002F{uuid}\u002Fconsumption-bills — consumption bills (merged view)",{"id":4400,"depth":309,"text":5030},"GET \u002Fcards\u002F{uuid}\u002Ftransactions — card transactions",{"id":4583,"depth":309,"text":5032},"POST \u002Fcards\u002F{uuid}\u002Ftopup — top up a card",{"id":4652,"depth":309,"text":5034},"POST \u002Fcards\u002F{uuid}\u002Ffreeze — freeze a card",{"id":4659,"depth":309,"text":5036},"POST \u002Fcards\u002F{uuid}\u002Funfreeze — unfreeze a card",{"id":4666,"depth":309,"text":5038},"POST \u002Fcards\u002F{uuid}\u002Fclose — close a card",{"id":853,"depth":309,"text":854,"children":5040},[5041,5042,5043,5044,5045],{"id":4706,"depth":327,"text":3488},{"id":4781,"depth":327,"text":3510},{"id":4814,"depth":327,"text":4431},{"id":4866,"depth":327,"text":4424},{"id":4945,"depth":327,"text":4328},"Issue, top-up, freeze, unfreeze, and close Visa virtual cards programmatically. Includes card transactions and lifecycle enums.",{},"\u002Fapi\u002Fvirtual-cards",{"title":3085,"description":5046},"api\u002F04.virtual-cards","Og9kD-1dABNx_gbQgg9qiiJFvc_hnsUEcAWtOdqaSms",{"id":4,"title":5,"body":5053,"category":1523,"description":1524,"extension":1525,"meta":6267,"navigation":1527,"order":363,"path":1528,"seo":6268,"stem":1530,"__hash__":1531},{"type":7,"value":5054,"toc":6253},[5055,5057,5061,5063,5067,5073,5125,5129,5211,5213,5217,5223,5231,5241,5243,5247,5253,5259,5437,5443,5445,5449,5455,5533,5537,5693,5707,5709,5711,5713,5765,5767,5819,5821,5829,5913,5915,6111,6113,6155,6157,6159,6251],[10,5056,5],{"id":12},[14,5058,16,5059,21],{},[18,5060,20],{},[23,5062],{},[26,5064,5065,33],{"id":28},[30,5066,32],{},[14,5068,5069,39,5071],{},[18,5070,38],{},[30,5072,42],{},[44,5074,5075,5085],{},[47,5076,5077],{},[50,5078,5079,5081,5083],{},[53,5080,55],{},[53,5082,58],{},[53,5084,61],{},[63,5086,5087,5101,5113],{},[50,5088,5089,5095,5097],{},[68,5090,5091,73,5093],{},[30,5092,72],{},[30,5094,76],{},[68,5096,79],{},[68,5098,82,5099,85],{},[30,5100,76],{},[50,5102,5103,5107,5109],{},[68,5104,5105],{},[30,5106,92],{},[68,5108,95],{},[68,5110,98,5111,104],{},[100,5112,103],{"href":102},[50,5114,5115,5119,5121],{},[68,5116,5117],{},[30,5118,111],{},[68,5120,95],{},[68,5122,116,5123,104],{},[100,5124,120],{"href":119},[14,5126,5127,126],{},[18,5128,125],{},[44,5130,5131,5141],{},[47,5132,5133],{},[50,5134,5135,5137,5139],{},[53,5136,135],{},[53,5138,58],{},[53,5140,140],{},[63,5142,5143,5153,5165,5177,5189,5201],{},[50,5144,5145,5149,5151],{},[68,5146,5147],{},[30,5148,149],{},[68,5150,149],{},[68,5152],{},[50,5154,5155,5159,5161],{},[68,5156,5157],{},[30,5158,111],{},[68,5160,95],{},[68,5162,164,5163],{},[100,5164,120],{"href":119},[50,5166,5167,5171,5173],{},[68,5168,5169],{},[30,5170,92],{},[68,5172,95],{},[68,5174,164,5175],{},[100,5176,103],{"href":102},[50,5178,5179,5183,5185],{},[68,5180,5181],{},[30,5182,185],{},[68,5184,188],{},[68,5186,191,5187],{},[100,5188,195],{"href":194},[50,5190,5191,5197,5199],{},[68,5192,5193,73,5195],{},[30,5194,202],{},[30,5196,205],{},[68,5198,95],{},[68,5200],{},[50,5202,5203,5207,5209],{},[68,5204,5205],{},[30,5206,216],{},[68,5208,219],{},[68,5210],{},[23,5212],{},[26,5214,5215,230],{"id":226},[30,5216,229],{},[14,5218,5219,39,5221],{},[18,5220,38],{},[30,5222,42],{},[14,5224,5225,39,5227,245,5229],{},[18,5226,241],{},[30,5228,244],{},[30,5230,248],{},[14,5232,5233,254,5235,257,5237,261,5239,265],{},[18,5234,253],{},[30,5236,92],{},[30,5238,260],{},[30,5240,264],{},[23,5242],{},[26,5244,5245,274],{"id":270},[30,5246,273],{},[14,5248,5249,39,5251],{},[18,5250,38],{},[30,5252,281],{},[14,5254,5255,126],{},[18,5256,286,5257],{},[30,5258,244],{},[290,5260,5261],{"className":292,"code":293,"language":294,"meta":295,"style":295},[30,5262,5263,5267,5279,5293,5305,5309,5327,5345,5363,5381,5393,5405,5421,5425,5429,5433],{"__ignoreMap":295},[299,5264,5265],{"class":301,"line":302},[299,5266,306],{"class":305},[299,5268,5269,5271,5273,5275,5277],{"class":301,"line":309},[299,5270,312],{"class":305},[299,5272,316],{"class":315},[299,5274,319],{"class":305},[299,5276,126],{"class":305},[299,5278,324],{"class":305},[299,5280,5281,5283,5285,5287,5289,5291],{"class":301,"line":327},[299,5282,330],{"class":305},[299,5284,334],{"class":333},[299,5286,319],{"class":305},[299,5288,126],{"class":305},[299,5290,342],{"class":341},[299,5292,345],{"class":305},[299,5294,5295,5297,5299,5301,5303],{"class":301,"line":348},[299,5296,330],{"class":305},[299,5298,353],{"class":333},[299,5300,319],{"class":305},[299,5302,126],{"class":305},[299,5304,360],{"class":305},[299,5306,5307],{"class":301,"line":363},[299,5308,366],{"class":305},[299,5310,5311,5313,5315,5317,5319,5321,5323,5325],{"class":301,"line":369},[299,5312,372],{"class":305},[299,5314,205],{"class":341},[299,5316,319],{"class":305},[299,5318,126],{"class":305},[299,5320,381],{"class":305},[299,5322,385],{"class":384},[299,5324,319],{"class":305},[299,5326,345],{"class":305},[299,5328,5329,5331,5333,5335,5337,5339,5341,5343],{"class":301,"line":392},[299,5330,372],{"class":305},[299,5332,397],{"class":341},[299,5334,319],{"class":305},[299,5336,126],{"class":305},[299,5338,381],{"class":305},[299,5340,406],{"class":384},[299,5342,319],{"class":305},[299,5344,345],{"class":305},[299,5346,5347,5349,5351,5353,5355,5357,5359,5361],{"class":301,"line":413},[299,5348,372],{"class":305},[299,5350,418],{"class":341},[299,5352,319],{"class":305},[299,5354,126],{"class":305},[299,5356,381],{"class":305},[299,5358,427],{"class":384},[299,5360,319],{"class":305},[299,5362,345],{"class":305},[299,5364,5365,5367,5369,5371,5373,5375,5377,5379],{"class":301,"line":434},[299,5366,372],{"class":305},[299,5368,439],{"class":341},[299,5370,319],{"class":305},[299,5372,126],{"class":305},[299,5374,381],{"class":305},[299,5376,448],{"class":384},[299,5378,319],{"class":305},[299,5380,345],{"class":305},[299,5382,5383,5385,5387,5389,5391],{"class":301,"line":455},[299,5384,372],{"class":305},[299,5386,460],{"class":341},[299,5388,319],{"class":305},[299,5390,126],{"class":305},[299,5392,467],{"class":305},[299,5394,5395,5397,5399,5401,5403],{"class":301,"line":470},[299,5396,372],{"class":305},[299,5398,475],{"class":341},[299,5400,319],{"class":305},[299,5402,126],{"class":305},[299,5404,467],{"class":305},[299,5406,5407,5409,5411,5413,5415,5417,5419],{"class":301,"line":484},[299,5408,372],{"class":305},[299,5410,489],{"class":341},[299,5412,319],{"class":305},[299,5414,126],{"class":305},[299,5416,381],{"class":305},[299,5418,498],{"class":384},[299,5420,501],{"class":305},[299,5422,5423],{"class":301,"line":504},[299,5424,507],{"class":305},[299,5426,5427],{"class":301,"line":510},[299,5428,513],{"class":305},[299,5430,5431],{"class":301,"line":516},[299,5432,519],{"class":305},[299,5434,5435],{"class":301,"line":522},[299,5436,525],{"class":305},[14,5438,5439,530,5441,265],{},[30,5440,353],{},[30,5442,533],{},[23,5444],{},[26,5446,5447,542],{"id":538},[30,5448,541],{},[14,5450,5451,39,5453],{},[18,5452,38],{},[30,5454,549],{},[44,5456,5457,5467],{},[47,5458,5459],{},[50,5460,5461,5463,5465],{},[53,5462,55],{},[53,5464,58],{},[53,5466,61],{},[63,5468,5469,5483,5495,5511,5521],{},[50,5470,5471,5477,5479],{},[68,5472,5473,73,5475],{},[30,5474,72],{},[30,5476,76],{},[68,5478,79],{},[68,5480,82,5481,85],{},[30,5482,76],{},[50,5484,5485,5489,5491],{},[68,5486,5487],{},[30,5488,584],{},[68,5490,95],{},[68,5492,589,5493,104],{},[100,5494,593],{"href":592},[50,5496,5497,5501,5503],{},[68,5498,5499],{},[30,5500,600],{},[68,5502,95],{},[68,5504,605,5505,609,5507,609,5509,104],{},[30,5506,608],{},[30,5508,612],{},[30,5510,615],{},[50,5512,5513,5517,5519],{},[68,5514,5515],{},[30,5516,622],{},[68,5518,149],{},[68,5520,627],{},[50,5522,5523,5529,5531],{},[68,5524,5525,73,5527],{},[30,5526,634],{},[30,5528,637],{},[68,5530,219],{},[68,5532,642],{},[14,5534,5535,126],{},[18,5536,647],{},[44,5538,5539,5549],{},[47,5540,5541],{},[50,5542,5543,5545,5547],{},[53,5544,135],{},[53,5546,58],{},[53,5548,140],{},[63,5550,5551,5561,5571,5583,5601,5615,5629,5639,5649,5663,5673,5683],{},[50,5552,5553,5557,5559],{},[68,5554,5555],{},[30,5556,668],{},[68,5558,79],{},[68,5560],{},[50,5562,5563,5567,5569],{},[68,5564,5565],{},[30,5566,679],{},[68,5568,95],{},[68,5570,684],{},[50,5572,5573,5577,5579],{},[68,5574,5575],{},[30,5576,691],{},[68,5578,95],{},[68,5580,696,5581],{},[100,5582,593],{"href":592},[50,5584,5585,5589,5593],{},[68,5586,5587],{},[30,5588,705],{},[68,5590,5591],{},[18,5592,79],{},[68,5594,5595,715,5597,719,5599,723],{},[30,5596,714],{},[30,5598,718],{},[18,5600,722],{},[50,5602,5603,5607,5609],{},[68,5604,5605],{},[30,5606,730],{},[68,5608,95],{},[68,5610,5611,73,5613],{},[30,5612,737],{},[30,5614,740],{},[50,5616,5617,5623,5625],{},[68,5618,5619,73,5621],{},[30,5620,747],{},[30,5622,205],{},[68,5624,95],{},[68,5626,754,5627],{},[30,5628,705],{},[50,5630,5631,5635,5637],{},[68,5632,5633],{},[30,5634,763],{},[68,5636,188],{},[68,5638],{},[50,5640,5641,5645,5647],{},[68,5642,5643],{},[30,5644,774],{},[68,5646,777],{},[68,5648,780],{},[50,5650,5651,5655,5657],{},[68,5652,5653],{},[30,5654,600],{},[68,5656,188],{},[68,5658,791,5659,609,5661,104],{},[30,5660,608],{},[30,5662,612],{},[50,5664,5665,5669,5671],{},[68,5666,5667],{},[30,5668,622],{},[68,5670,777],{},[68,5672,806],{},[50,5674,5675,5679,5681],{},[68,5676,5677],{},[30,5678,813],{},[68,5680,188],{},[68,5682],{},[50,5684,5685,5689,5691],{},[68,5686,5687],{},[30,5688,216],{},[68,5690,219],{},[68,5692],{},[829,5694,5695],{},[14,5696,833,5697,836,5699,839,5701,842,5703,845,5705,848],{},[30,5698,705],{},[18,5700,722],{},[30,5702,714],{},[30,5704,718],{},[30,5706,730],{},[23,5708],{},[26,5710,854],{"id":853},[856,5712,103],{"id":858},[44,5714,5715,5723],{},[47,5716,5717],{},[50,5718,5719,5721],{},[53,5720,867],{},[53,5722,870],{},[63,5724,5725,5733,5741,5749,5757],{},[50,5726,5727,5731],{},[68,5728,5729],{},[30,5730,879],{},[68,5732,882],{},[50,5734,5735,5739],{},[68,5736,5737],{},[30,5738,889],{},[68,5740,892],{},[50,5742,5743,5747],{},[68,5744,5745],{},[30,5746,899],{},[68,5748,902],{},[50,5750,5751,5755],{},[68,5752,5753],{},[30,5754,260],{},[68,5756,911],{},[50,5758,5759,5763],{},[68,5760,5761],{},[30,5762,264],{},[68,5764,920],{},[856,5766,120],{"id":923},[44,5768,5769,5777],{},[47,5770,5771],{},[50,5772,5773,5775],{},[53,5774,867],{},[53,5776,870],{},[63,5778,5779,5787,5795,5803,5811],{},[50,5780,5781,5785],{},[68,5782,5783],{},[30,5784,942],{},[68,5786,945],{},[50,5788,5789,5793],{},[68,5790,5791],{},[30,5792,952],{},[68,5794,955],{},[50,5796,5797,5801],{},[68,5798,5799],{},[30,5800,962],{},[68,5802,965],{},[50,5804,5805,5809],{},[68,5806,5807],{},[30,5808,972],{},[68,5810,975],{},[50,5812,5813,5817],{},[68,5814,5815],{},[30,5816,982],{},[68,5818,985],{},[856,5820,989],{"id":988},[829,5822,5823],{},[14,5824,994,5825,73,5827,1001],{},[30,5826,997],{},[30,5828,1000],{},[44,5830,5831,5839],{},[47,5832,5833],{},[50,5834,5835,5837],{},[53,5836,867],{},[53,5838,870],{},[63,5840,5841,5849,5857,5865,5873,5881,5889,5897,5905],{},[50,5842,5843,5847],{},[68,5844,5845],{},[30,5846,997],{},[68,5848,1022],{},[50,5850,5851,5855],{},[68,5852,5853],{},[30,5854,1029],{},[68,5856,1032],{},[50,5858,5859,5863],{},[68,5860,5861],{},[30,5862,1039],{},[68,5864,1042],{},[50,5866,5867,5871],{},[68,5868,5869],{},[30,5870,1049],{},[68,5872,1052],{},[50,5874,5875,5879],{},[68,5876,5877],{},[30,5878,1000],{},[68,5880,1061],{},[50,5882,5883,5887],{},[68,5884,5885],{},[30,5886,1068],{},[68,5888,1071],{},[50,5890,5891,5895],{},[68,5892,5893],{},[30,5894,1078],{},[68,5896,1081],{},[50,5898,5899,5903],{},[68,5900,5901],{},[30,5902,1088],{},[68,5904,1091],{},[50,5906,5907,5911],{},[68,5908,5909],{},[30,5910,1098],{},[68,5912,1101],{},[856,5914,1105],{"id":1104},[44,5916,5917,5925],{},[47,5918,5919],{},[50,5920,5921,5923],{},[53,5922,867],{},[53,5924,870],{},[63,5926,5927,5935,5943,5951,5959,5967,5975,5983,5991,5999,6007,6015,6023,6031,6039,6047,6055,6063,6071,6079,6087,6095,6103],{},[50,5928,5929,5933],{},[68,5930,5931],{},[30,5932,1124],{},[68,5934,1127],{},[50,5936,5937,5941],{},[68,5938,5939],{},[30,5940,1134],{},[68,5942,1137],{},[50,5944,5945,5949],{},[68,5946,5947],{},[30,5948,1144],{},[68,5950,1147],{},[50,5952,5953,5957],{},[68,5954,5955],{},[30,5956,1154],{},[68,5958,1157],{},[50,5960,5961,5965],{},[68,5962,5963],{},[30,5964,1164],{},[68,5966,1167],{},[50,5968,5969,5973],{},[68,5970,5971],{},[30,5972,1174],{},[68,5974,1177],{},[50,5976,5977,5981],{},[68,5978,5979],{},[30,5980,1184],{},[68,5982,1187],{},[50,5984,5985,5989],{},[68,5986,5987],{},[30,5988,1194],{},[68,5990,1197],{},[50,5992,5993,5997],{},[68,5994,5995],{},[30,5996,1204],{},[68,5998,1207],{},[50,6000,6001,6005],{},[68,6002,6003],{},[30,6004,1214],{},[68,6006,1217],{},[50,6008,6009,6013],{},[68,6010,6011],{},[30,6012,1224],{},[68,6014,1227],{},[50,6016,6017,6021],{},[68,6018,6019],{},[30,6020,1234],{},[68,6022,1237],{},[50,6024,6025,6029],{},[68,6026,6027],{},[30,6028,1244],{},[68,6030,1247],{},[50,6032,6033,6037],{},[68,6034,6035],{},[30,6036,1254],{},[68,6038,1257],{},[50,6040,6041,6045],{},[68,6042,6043],{},[30,6044,1264],{},[68,6046,1267],{},[50,6048,6049,6053],{},[68,6050,6051],{},[30,6052,1274],{},[68,6054,1277],{},[50,6056,6057,6061],{},[68,6058,6059],{},[30,6060,1284],{},[68,6062,1287],{},[50,6064,6065,6069],{},[68,6066,6067],{},[30,6068,1294],{},[68,6070,1297],{},[50,6072,6073,6077],{},[68,6074,6075],{},[30,6076,1304],{},[68,6078,1307],{},[50,6080,6081,6085],{},[68,6082,6083],{},[30,6084,1314],{},[68,6086,1317],{},[50,6088,6089,6093],{},[68,6090,6091],{},[30,6092,1324],{},[68,6094,1327],{},[50,6096,6097,6101],{},[68,6098,6099],{},[30,6100,1334],{},[68,6102,1337],{},[50,6104,6105,6109],{},[68,6106,6107],{},[30,6108,1344],{},[68,6110,1347],{},[856,6112,1351],{"id":1350},[44,6114,6115,6129],{},[47,6116,6117],{},[50,6118,6119,6123,6127],{},[53,6120,6121,1362],{},[30,6122,705],{},[53,6124,6125],{},[30,6126,730],{},[53,6128,870],{},[63,6130,6131,6143],{},[50,6132,6133,6137,6141],{},[68,6134,6135],{},[30,6136,714],{},[68,6138,6139],{},[30,6140,737],{},[68,6142,1383],{},[50,6144,6145,6149,6153],{},[68,6146,6147],{},[30,6148,718],{},[68,6150,6151],{},[30,6152,740],{},[68,6154,1396],{},[23,6156],{},[26,6158,1402],{"id":1401},[44,6160,6161,6171],{},[47,6162,6163],{},[50,6164,6165,6167,6169],{},[53,6166,135],{},[53,6168,58],{},[53,6170,140],{},[63,6172,6173,6183,6195,6207,6217,6229,6241],{},[50,6174,6175,6179,6181],{},[68,6176,6177],{},[30,6178,149],{},[68,6180,149],{},[68,6182,1427],{},[50,6184,6185,6189,6191],{},[68,6186,6187],{},[30,6188,111],{},[68,6190,95],{},[68,6192,164,6193],{},[100,6194,120],{"href":119},[50,6196,6197,6201,6203],{},[68,6198,6199],{},[30,6200,92],{},[68,6202,95],{},[68,6204,164,6205],{},[100,6206,103],{"href":102},[50,6208,6209,6213,6215],{},[68,6210,6211],{},[30,6212,1458],{},[68,6214,777],{},[68,6216,780],{},[50,6218,6219,6223,6225],{},[68,6220,6221],{},[30,6222,202],{},[68,6224,95],{},[68,6226,1473,6227],{},[30,6228,1476],{},[50,6230,6231,6235,6237],{},[68,6232,6233],{},[30,6234,205],{},[68,6236,95],{},[68,6238,1487,6239],{},[30,6240,1490],{},[50,6242,6243,6247,6249],{},[68,6244,6245],{},[30,6246,216],{},[68,6248,219],{},[68,6250],{},[1502,6252,1504],{},{"title":295,"searchDepth":309,"depth":309,"links":6254},[6255,6256,6257,6258,6259,6266],{"id":28,"depth":309,"text":1508},{"id":226,"depth":309,"text":1510},{"id":270,"depth":309,"text":1512},{"id":538,"depth":309,"text":1514},{"id":853,"depth":309,"text":854,"children":6260},[6261,6262,6263,6264,6265],{"id":858,"depth":327,"text":103},{"id":923,"depth":327,"text":120},{"id":988,"depth":327,"text":989},{"id":1104,"depth":327,"text":1105},{"id":1350,"depth":327,"text":1351},{"id":1401,"depth":309,"text":1402},{},{"title":5,"description":1524},{"id":6270,"title":6271,"body":6272,"category":1523,"description":6776,"extension":1525,"meta":6777,"navigation":1527,"order":369,"path":6778,"seo":6779,"stem":6780,"__hash__":6781},"content_en\u002Fapi\u002F06.webhooks.md","Webhooks",{"type":7,"value":6273,"toc":6767},[6274,6277,6285,6287,6292,6302,6309,6313,6488,6525,6529,6549,6553,6572,6574,6580,6589,6597,6764],[10,6275,6271],{"id":6276},"webhooks",[14,6278,6279,6280,6284],{},"Dotva delivers webhook events to your configured HTTP endpoints. Currently one event is available for the server-to-server API: ",[18,6281,6282],{},[30,6283,3865],{},", which delivers the encrypted PAN \u002F CVV \u002F expiry after a card is successfully issued.",[23,6286],{},[26,6288,6290],{"id":6289},"cardissuedsecrets",[30,6291,3865],{},[14,6293,6294,6295,6298,6299,6301],{},"After a card is issued, if the workspace has configured an ",[18,6296,6297],{},"RSA public key"," and has an endpoint subscribed to ",[30,6300,3865],{},", the platform delivers this webhook.",[829,6303,6304],{},[14,6305,6306],{},[18,6307,6308],{},"Encrypted card secrets are delivered only via this webhook — they never appear in regular API responses.",[856,6310,6312],{"id":6311},"payload","Payload",[290,6314,6316],{"className":292,"code":6315,"language":294,"meta":295,"style":295},"{\n  \"event\": \"card.issued.secrets\",\n  \"workspace_id\": 12,\n  \"data\": {\n    \"card_id\": 345,\n    \"card_uuid\": \"8f1c...\",\n    \"card_last4\": \"4242\",\n    \"card_bin\": \"411111\",\n    \"secrets_jwe\": \"\u003CJWE compact string>\",\n    \"key_fingerprint\": \"sha256:9c4d...\"\n  }\n}\n",[30,6317,6318,6322,6341,6355,6367,6383,6402,6422,6442,6462,6480,6484],{"__ignoreMap":295},[299,6319,6320],{"class":301,"line":302},[299,6321,306],{"class":305},[299,6323,6324,6326,6329,6331,6333,6335,6337,6339],{"class":301,"line":309},[299,6325,312],{"class":305},[299,6327,6328],{"class":315},"event",[299,6330,319],{"class":305},[299,6332,126],{"class":305},[299,6334,381],{"class":305},[299,6336,3865],{"class":384},[299,6338,319],{"class":305},[299,6340,345],{"class":305},[299,6342,6343,6345,6347,6349,6351,6353],{"class":301,"line":327},[299,6344,312],{"class":305},[299,6346,334],{"class":315},[299,6348,319],{"class":305},[299,6350,126],{"class":305},[299,6352,342],{"class":341},[299,6354,345],{"class":305},[299,6356,6357,6359,6361,6363,6365],{"class":301,"line":348},[299,6358,312],{"class":305},[299,6360,316],{"class":315},[299,6362,319],{"class":305},[299,6364,126],{"class":305},[299,6366,324],{"class":305},[299,6368,6369,6371,6374,6376,6378,6381],{"class":301,"line":363},[299,6370,330],{"class":305},[299,6372,6373],{"class":333},"card_id",[299,6375,319],{"class":305},[299,6377,126],{"class":305},[299,6379,6380],{"class":341}," 345",[299,6382,345],{"class":305},[299,6384,6385,6387,6390,6392,6394,6396,6398,6400],{"class":301,"line":369},[299,6386,330],{"class":305},[299,6388,6389],{"class":333},"card_uuid",[299,6391,319],{"class":305},[299,6393,126],{"class":305},[299,6395,381],{"class":305},[299,6397,2082],{"class":384},[299,6399,319],{"class":305},[299,6401,345],{"class":305},[299,6403,6404,6406,6409,6411,6413,6415,6418,6420],{"class":301,"line":392},[299,6405,330],{"class":305},[299,6407,6408],{"class":333},"card_last4",[299,6410,319],{"class":305},[299,6412,126],{"class":305},[299,6414,381],{"class":305},[299,6416,6417],{"class":384},"4242",[299,6419,319],{"class":305},[299,6421,345],{"class":305},[299,6423,6424,6426,6429,6431,6433,6435,6438,6440],{"class":301,"line":413},[299,6425,330],{"class":305},[299,6427,6428],{"class":333},"card_bin",[299,6430,319],{"class":305},[299,6432,126],{"class":305},[299,6434,381],{"class":305},[299,6436,6437],{"class":384},"411111",[299,6439,319],{"class":305},[299,6441,345],{"class":305},[299,6443,6444,6446,6449,6451,6453,6455,6458,6460],{"class":301,"line":434},[299,6445,330],{"class":305},[299,6447,6448],{"class":333},"secrets_jwe",[299,6450,319],{"class":305},[299,6452,126],{"class":305},[299,6454,381],{"class":305},[299,6456,6457],{"class":384},"\u003CJWE compact string>",[299,6459,319],{"class":305},[299,6461,345],{"class":305},[299,6463,6464,6466,6469,6471,6473,6475,6478],{"class":301,"line":455},[299,6465,330],{"class":305},[299,6467,6468],{"class":333},"key_fingerprint",[299,6470,319],{"class":305},[299,6472,126],{"class":305},[299,6474,381],{"class":305},[299,6476,6477],{"class":384},"sha256:9c4d...",[299,6479,501],{"class":305},[299,6481,6482],{"class":301,"line":470},[299,6483,519],{"class":305},[299,6485,6486],{"class":301,"line":484},[299,6487,525],{"class":305},[44,6489,6490,6498],{},[47,6491,6492],{},[50,6493,6494,6496],{},[53,6495,135],{},[53,6497,61],{},[63,6499,6500,6516],{},[50,6501,6502,6506],{},[68,6503,6504],{},[30,6505,6448],{},[68,6507,6508,6509,4386,6512,6515],{},"JWE compact serialization (",[30,6510,6511],{},"RSA-OAEP-256",[30,6513,6514],{},"A256GCM","). Decrypt with your private key to obtain PAN \u002F CVV \u002F expiry.",[50,6517,6518,6522],{},[68,6519,6520],{},[30,6521,6468],{},[68,6523,6524],{},"SHA-256 fingerprint of the public key used to encrypt, so you know which private key to use for decryption.",[856,6526,6528],{"id":6527},"delivery-acknowledgment","Delivery & acknowledgment",[1581,6530,6531,6537,6543],{},[1584,6532,6533,6534,6536],{},"Reply ",[30,6535,244],{}," (any body) to acknowledge receipt.",[1584,6538,6539,6540,6542],{},"Non-",[30,6541,244],{}," responses trigger retries with exponential back-off.",[1584,6544,6545,6546,6548],{},"Duplicate deliveries are possible — make your handler idempotent (use ",[30,6547,6389],{}," as the deduplication key).",[856,6550,6552],{"id":6551},"setting-up","Setting up",[1641,6554,6555,6561,6566],{},[1584,6556,6557,6558,265],{},"Upload your RSA public key in ",[18,6559,6560],{},"Developer Settings → Webhook Keys",[1584,6562,6563,6564,265],{},"Register your endpoint URL and subscribe it to ",[30,6565,3865],{},[1584,6567,6568,6569,6571],{},"After issuing a card via ",[30,6570,2431],{},", wait for the webhook delivery (typically within seconds of the order completing).",[23,6573],{},[26,6575,6577,6578],{"id":6576},"decrypting-secrets_jwe","Decrypting ",[30,6579,6448],{},[14,6581,6582,6583,6585,6586,6588],{},"The JWE uses ",[18,6584,6511],{}," for key encryption and ",[18,6587,6514],{}," for content encryption. Most modern crypto libraries support this out of the box.",[14,6590,6591,126],{},[18,6592,6593,6594,104],{},"Node.js example (using ",[30,6595,6596],{},"jose",[290,6598,6602],{"className":6599,"code":6600,"language":6601,"meta":295,"style":295},"language-js shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { compactDecrypt } from 'jose'\nimport { createPrivateKey } from 'crypto'\n\nconst privateKey = createPrivateKey({ key: process.env.PRIVATE_KEY_PEM })\nconst { plaintext } = await compactDecrypt(secrets_jwe, privateKey)\nconst secrets = JSON.parse(new TextDecoder().decode(plaintext))\n\u002F\u002F secrets.pan, secrets.cvv, secrets.expiry_month, secrets.expiry_year\n","js",[30,6603,6604,6628,6648,6652,6696,6723,6759],{"__ignoreMap":295},[299,6605,6606,6610,6613,6616,6619,6622,6624,6626],{"class":301,"line":302},[299,6607,6609],{"class":6608},"s7zQu","import",[299,6611,6612],{"class":305}," {",[299,6614,6615],{"class":1690}," compactDecrypt",[299,6617,6618],{"class":305}," }",[299,6620,6621],{"class":6608}," from",[299,6623,1821],{"class":305},[299,6625,6596],{"class":384},[299,6627,1851],{"class":305},[299,6629,6630,6632,6634,6637,6639,6641,6643,6646],{"class":301,"line":309},[299,6631,6609],{"class":6608},[299,6633,6612],{"class":305},[299,6635,6636],{"class":1690}," createPrivateKey",[299,6638,6618],{"class":305},[299,6640,6621],{"class":6608},[299,6642,1821],{"class":305},[299,6644,6645],{"class":384},"crypto",[299,6647,1851],{"class":305},[299,6649,6650],{"class":301,"line":327},[299,6651,1708],{"emptyLinePlaceholder":1527},[299,6653,6654,6657,6660,6663,6666,6669,6671,6675,6677,6680,6682,6685,6687,6690,6693],{"class":301,"line":348},[299,6655,6656],{"class":315},"const",[299,6658,6659],{"class":1690}," privateKey ",[299,6661,6662],{"class":305},"=",[299,6664,6636],{"class":6665},"s2Zo4",[299,6667,6668],{"class":1690},"(",[299,6670,2657],{"class":305},[299,6672,6674],{"class":6673},"swJcz"," key",[299,6676,126],{"class":305},[299,6678,6679],{"class":1690}," process",[299,6681,265],{"class":305},[299,6683,6684],{"class":1690},"env",[299,6686,265],{"class":305},[299,6688,6689],{"class":1690},"PRIVATE_KEY_PEM ",[299,6691,6692],{"class":305},"}",[299,6694,6695],{"class":1690},")\n",[299,6697,6698,6700,6702,6705,6707,6710,6713,6715,6718,6720],{"class":301,"line":363},[299,6699,6656],{"class":315},[299,6701,6612],{"class":305},[299,6703,6704],{"class":1690}," plaintext ",[299,6706,6692],{"class":305},[299,6708,6709],{"class":305}," =",[299,6711,6712],{"class":6608}," await",[299,6714,6615],{"class":6665},[299,6716,6717],{"class":1690},"(secrets_jwe",[299,6719,2008],{"class":305},[299,6721,6722],{"class":1690}," privateKey)\n",[299,6724,6725,6727,6730,6732,6735,6737,6740,6742,6745,6748,6751,6753,6756],{"class":301,"line":369},[299,6726,6656],{"class":315},[299,6728,6729],{"class":1690}," secrets ",[299,6731,6662],{"class":305},[299,6733,6734],{"class":1690}," JSON",[299,6736,265],{"class":305},[299,6738,6739],{"class":6665},"parse",[299,6741,6668],{"class":1690},[299,6743,6744],{"class":305},"new",[299,6746,6747],{"class":6665}," TextDecoder",[299,6749,6750],{"class":1690},"()",[299,6752,265],{"class":305},[299,6754,6755],{"class":6665},"decode",[299,6757,6758],{"class":1690},"(plaintext))\n",[299,6760,6761],{"class":301,"line":392},[299,6762,6763],{"class":1675},"\u002F\u002F secrets.pan, secrets.cvv, secrets.expiry_month, secrets.expiry_year\n",[1502,6765,6766],{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}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 .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}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}",{"title":295,"searchDepth":309,"depth":309,"links":6768},[6769,6774],{"id":6289,"depth":309,"text":3865,"children":6770},[6771,6772,6773],{"id":6311,"depth":327,"text":6312},{"id":6527,"depth":327,"text":6528},{"id":6551,"depth":327,"text":6552},{"id":6576,"depth":309,"text":6775},"Decrypting secrets_jwe","Configure webhook endpoints, the card.issued.secrets event, JWE encrypted card secrets, and delivery acknowledgment.",{},"\u002Fapi\u002Fwebhooks",{"title":6271,"description":6776},"api\u002F06.webhooks","UJy13ob4gk_sEdIiqptoacYiHHZhOs7bLNjOvEWiepQ",{"id":6783,"title":6784,"body":6785,"category":7395,"description":7396,"extension":1525,"meta":7397,"navigation":1527,"order":302,"path":7398,"seo":7399,"stem":7400,"__hash__":7401},"content_en\u002Ffaq\u002F01.general.md","Frequently Asked Questions",{"type":7,"value":6786,"toc":7337},[6787,6790,6794,6798,6801,6805,6808,6840,6844,6847,6849,6853,6857,6866,6870,6873,6877,6880,6882,6886,6890,6905,6909,6917,6921,6924,6938,6942,6949,6953,6956,6960,6967,6971,6974,7002,7005,7012,7020,7022,7026,7030,7033,7037,7044,7048,7054,7058,7061,7065,7068,7072,7083,7087,7090,7101,7103,7107,7111,7118,7122,7125,7136,7139,7143,7150,7152,7156,7160,7163,7167,7170,7174,7177,7179,7183,7187,7195,7199,7206,7210,7213,7217,7227,7231,7242,7244,7248,7252,7255,7259,7285,7289,7312,7314,7318,7322,7330,7334],[10,6788,6784],{"id":6789},"frequently-asked-questions",[26,6791,6793],{"id":6792},"general","General",[856,6795,6797],{"id":6796},"what-is-dotva","What is Dotva?",[14,6799,6800],{},"Dotva is a financial management system built for SMBs, teams, and individuals. It replaces the traditional \"pay out-of-pocket, submit for reimbursement\" workflow with a structured virtual card issuance model — giving organizations real-time control over employee spending without the friction of expense reports. Virtual cards are the instrument Dotva uses to enforce spending policies; the platform itself handles budgeting, approvals, transaction visibility, and reconciliation.",[856,6802,6804],{"id":6803},"who-is-dotva-for","Who is Dotva for?",[14,6806,6807],{},"Dotva is designed for any organization that needs to control distributed spending:",[1581,6809,6810,6816,6822,6828,6834],{},[1584,6811,6812,6815],{},[18,6813,6814],{},"Finance teams"," eliminating manual expense reimbursement cycles",[1584,6817,6818,6821],{},[18,6819,6820],{},"Remote and distributed teams"," that need payment tools without physical card logistics",[1584,6823,6824,6827],{},[18,6825,6826],{},"SaaS companies"," allocating per-project or per-department budgets",[1584,6829,6830,6833],{},[18,6831,6832],{},"Agencies"," managing client campaign spend",[1584,6835,6836,6839],{},[18,6837,6838],{},"Freelancers and individuals"," who want separate, purpose-limited cards for subscriptions and online purchases",[856,6841,6843],{"id":6842},"is-dotva-a-bank","Is Dotva a bank?",[14,6845,6846],{},"No. Dotva is a financial technology platform. Virtual cards are issued through licensed card program providers. Dotva does not hold a banking license and does not provide deposit insurance.",[23,6848],{},[26,6850,6852],{"id":6851},"accounts-registration","Accounts & Registration",[856,6854,6856],{"id":6855},"how-do-i-create-an-account","How do I create an account?",[14,6858,6859,6860,6865],{},"Visit ",[100,6861,6862],{"href":6862,"rel":6863},"https:\u002F\u002Fwww.dotva.io\u002Fregister",[6864],"nofollow",", enter your email address, and set a password. After verifying your email, you can create your first workspace.",[856,6867,6869],{"id":6868},"how-do-workspaces-work","How do workspaces work?",[14,6871,6872],{},"Each account automatically has one primary workspace created at registration. Workspaces are the unit of financial management — they hold the wallet, cards, staff, and subscription. A single account can be a member of multiple workspaces (e.g. as a delegate or staff member for another organization), and you can switch between them from the sidebar.",[856,6874,6876],{"id":6875},"is-two-factor-authentication-required","Is two-factor authentication required?",[14,6878,6879],{},"TOTP-based 2FA is optional for workspace owners and staff but strongly recommended. It is required for platform administrators. Certain sensitive operations — such as viewing card secrets or submitting large withdrawals — trigger a step-up re-verification regardless of whether 2FA is enabled.",[23,6881],{},[26,6883,6885],{"id":6884},"virtual-cards","Virtual Cards",[856,6887,6889],{"id":6888},"what-card-networks-does-dotva-support","What card networks does Dotva support?",[14,6891,6892,6893,6896,6897,6900,6901,6904],{},"Dotva currently issues ",[18,6894,6895],{},"Visa"," virtual cards, with ",[18,6898,6899],{},"Mastercard"," and ",[18,6902,6903],{},"JCB"," support in progress. As additional card programs are integrated, new card products will appear in your product catalogue automatically.",[856,6906,6908],{"id":6907},"how-fast-are-cards-issued","How fast are cards issued?",[14,6910,6911,6912,3183,6914,6916],{},"Card issuance is typically completed within a few seconds after the order is accepted. The card transitions from ",[30,6913,4725],{},[30,6915,4735],{}," once the issuer confirms.",[856,6918,6920],{"id":6919},"what-are-the-card-fees","What are the card fees?",[14,6922,6923],{},"Fees vary by card product. Before issuing a card, the product picker shows the exact issuance fee and top-up fee for each product. A typical example:",[1581,6925,6926,6932],{},[1584,6927,6928,6931],{},[18,6929,6930],{},"Issuance fee",": $3.00 (one-time, deducted from the initial top-up)",[1584,6933,6934,6937],{},[18,6935,6936],{},"Top-up fee",": 3% of the top-up amount",[856,6939,6941],{"id":6940},"can-i-freeze-a-card","Can I freeze a card?",[14,6943,6944,6945,6948],{},"Freeze support depends on the specific card product. Not all products support freeze \u002F unfreeze. Check the card's capability flags before attempting to freeze — if the ",[18,6946,6947],{},"Freeze"," button is visible, the product supports it. Frozen cards will decline all transactions until unfrozen.",[856,6950,6952],{"id":6951},"what-happens-to-funds-when-i-close-a-card","What happens to funds when I close a card?",[14,6954,6955],{},"When you close a card, the remaining balance is automatically returned to your workspace wallet within approximately 24–48 hours after the card is settled.",[856,6957,6959],{"id":6958},"how-do-i-view-a-cards-pan-cvv-and-expiry","How do I view a card's PAN, CVV, and expiry?",[14,6961,6962,6963,6966],{},"In the card detail page, click ",[18,6964,6965],{},"Verify & Reveal",". You will be prompted to re-enter your password or TOTP code (step-up authentication). After verification, the card number, CVV, and expiry are displayed for a short window. Secrets are shown in-browser only and are never stored in plaintext.",[856,6968,6970],{"id":6969},"why-did-a-transaction-fail-how-do-i-identify-the-cause","Why did a transaction fail? How do I identify the cause?",[14,6972,6973],{},"There are two scenarios:",[1641,6975,6976,6996],{},[1584,6977,6978,6981,6982,6984,6985,609,6987,609,6989,609,6991,6993,6994,265],{},[18,6979,6980],{},"A declined bill appears in the transaction list"," — open the bill to see the ",[30,6983,4320],{}," field. Common reasons include ",[30,6986,4964],{},[30,6988,4974],{},[30,6990,4984],{},[30,6992,4994],{},", and ",[30,6995,5004],{},[1584,6997,6998,7001],{},[18,6999,7000],{},"No declined bill appears at all"," — this means the transaction was blocked at the merchant's side (e.g. by their fraud prevention or payment gateway) before it ever reached our card network. In this case we receive no notification and cannot provide a specific failure reason. The most common causes are merchant-side CVV checks, AVS strictness, or velocity controls on the merchant's processor.",[14,7003,7004],{},"If you repeatedly experience unexplained failures at a specific merchant, check whether the billing address on the card matches exactly what the merchant expects, and contact the merchant's support for details.",[856,7006,7008,7009,7011],{"id":7007},"what-does-a-risk_blocked-decline-mean","What does a ",[30,7010,5004],{}," decline mean?",[14,7013,7014,7015,7019],{},"The transaction was declined by Dotva's risk engine — for example, because the merchant is in a restricted category (gambling, adult content, cryptocurrency), or because a risk rule was triggered (consecutive failures, multi-country rapid spending, etc.). See the ",[100,7016,7018],{"href":7017},"\u002Fresources\u002Frisk\u002Frisk-policy","Risk Control Policy"," for details.",[23,7021],{},[26,7023,7025],{"id":7024},"wallet-deposits","Wallet & Deposits",[856,7027,7029],{"id":7028},"what-currency-is-the-wallet-in","What currency is the wallet in?",[14,7031,7032],{},"Wallet balances are denominated in USD.",[856,7034,7036],{"id":7035},"how-do-i-deposit-funds","How do I deposit funds?",[14,7038,7039,7040,7043],{},"Go to ",[18,7041,7042],{},"Wallet → Deposit",". The system generates a dedicated USDT (TRC20) address for your workspace. Send USDT to that address. Once the on-chain transaction is confirmed, your USD balance is credited automatically. USDT conversion to USD is handled by our third-party payment partner — the credited amount reflects the rate applied at the time of settlement.",[856,7045,7047],{"id":7046},"what-is-the-deposit-fee","What is the deposit fee?",[14,7049,7050,7053],{},[18,7051,7052],{},"$2.00 flat + 1% of the deposit amount."," For example, a $1,000 deposit incurs a $12.00 fee and credits $988.00 to your wallet.",[856,7055,7057],{"id":7056},"how-long-does-a-deposit-take","How long does a deposit take?",[14,7059,7060],{},"TRC20 deposits typically confirm within 3–5 minutes, depending on network congestion. The credit appears in your wallet as soon as confirmation is received.",[856,7062,7064],{"id":7063},"what-is-the-minimum-deposit","What is the minimum deposit?",[14,7066,7067],{},"200 USDT.",[856,7069,7071],{"id":7070},"can-i-withdraw-funds","Can I withdraw funds?",[14,7073,7074,7075,7078,7079,7082],{},"Yes. Go to ",[18,7076,7077],{},"Wallet → Withdraw"," and submit a withdrawal request. Withdrawals are processed in USDT and take ",[18,7080,7081],{},"7–15 business days"," after passing compliance review. Only one pending withdrawal request is allowed per workspace at a time.",[856,7084,7086],{"id":7085},"why-might-a-withdrawal-be-delayed","Why might a withdrawal be delayed?",[14,7088,7089],{},"Withdrawals may be delayed or held if:",[1581,7091,7092,7095,7098],{},[1584,7093,7094],{},"The workspace has active risk flags or an outstanding compliance review",[1584,7096,7097],{},"There are unpaid fee obligations (e.g. negative wallet balance from risk penalties)",[1584,7099,7100],{},"The requested amount exceeds the available cleared balance",[23,7102],{},[26,7104,7106],{"id":7105},"team-staff","Team & Staff",[856,7108,7110],{"id":7109},"do-i-need-a-subscription-to-add-staff","Do I need a subscription to add staff?",[14,7112,7113,7114,7117],{},"Yes. Adding staff members requires the ",[18,7115,7116],{},"Staff Seats"," add-on subscription ($1.99\u002Fseat\u002Fmonth; discounts apply for 20+ seats).",[856,7119,7121],{"id":7120},"what-can-staff-members-do","What can staff members do?",[14,7123,7124],{},"Staff can:",[1581,7126,7127,7130,7133],{},[1584,7128,7129],{},"View and use their assigned virtual cards",[1584,7131,7132],{},"Submit tickets for card top-up and card closure",[1584,7134,7135],{},"View their own transaction history and card details",[14,7137,7138],{},"Staff cannot manage the workspace wallet, invite other members, or access workspace settings.",[856,7140,7142],{"id":7141},"can-i-grant-a-team-member-elevated-access","Can I grant a team member elevated access?",[14,7144,7145,7146,7149],{},"Yes. You can add a ",[18,7147,7148],{},"Delegate"," with owner-level or custom-permission access via RBAC. Delegates can manage most workspace functions depending on the roles granted.",[23,7151],{},[26,7153,7155],{"id":7154},"subscriptions","Subscriptions",[856,7157,7159],{"id":7158},"how-are-subscription-fees-charged","How are subscription fees charged?",[14,7161,7162],{},"Subscription fees are deducted directly from your workspace wallet on the billing date. No external payment method is required.",[856,7164,7166],{"id":7165},"what-happens-if-my-wallet-balance-is-insufficient-at-renewal","What happens if my wallet balance is insufficient at renewal?",[14,7168,7169],{},"The subscription will not renew automatically. The associated features are suspended until you top up the wallet and manually renew the subscription.",[856,7171,7173],{"id":7172},"can-i-cancel-a-subscription","Can I cancel a subscription?",[14,7175,7176],{},"Yes. You can cancel at any time from the Subscription page. The subscription remains active until the end of the current billing period and will not renew.",[23,7178],{},[26,7180,7182],{"id":7181},"developer","Developer",[856,7184,7186],{"id":7185},"is-there-an-api","Is there an API?",[14,7188,7189,7190,7194],{},"Yes. Dotva provides a full REST API covering cards, wallet, orders, and webhooks. See the ",[100,7191,7193],{"href":7192},"\u002Fresources\u002Fapi\u002Foverview","API Overview"," for documentation.",[856,7196,7198],{"id":7197},"is-api-access-available-on-all-plans","Is API access available on all plans?",[14,7200,7201,7202,7205],{},"No. Full API access (token issuance, webhook delivery) requires the ",[18,7203,7204],{},"Developer subscription"," ($199\u002Fmonth). Without an active Developer subscription, API token creation and webhook endpoints are disabled.",[856,7207,7209],{"id":7208},"does-the-api-use-cookies-or-sessions","Does the API use cookies or sessions?",[14,7211,7212],{},"No. The API uses Bearer token authentication exclusively. There are no cookies, CSRF tokens, or server-side session state.",[856,7214,7216],{"id":7215},"how-do-i-receive-real-time-events","How do I receive real-time events?",[14,7218,7219,7220,7223,7224,7226],{},"Configure a webhook endpoint in ",[18,7221,7222],{},"Settings → Developer → Webhooks",". Dotva will POST signed event payloads to your URL as events occur (e.g. ",[30,7225,3865],{}," after card issuance).",[856,7228,7230],{"id":7229},"are-webhook-payloads-signed","Are webhook payloads signed?",[14,7232,7233,7234,7237,7238,7241],{},"Yes. Every webhook delivery includes an ",[30,7235,7236],{},"X-Dotva-Signature"," header (",[30,7239,7240],{},"sha256=\u003CHMAC-SHA256 hex>","). Always verify this signature before processing the payload to prevent replay and spoofing attacks.",[23,7243],{},[26,7245,7247],{"id":7246},"security","Security",[856,7249,7251],{"id":7250},"is-my-card-data-safe","Is my card data safe?",[14,7253,7254],{},"Yes. Card secrets (PAN, CVV, expiry) are stored using Envelope Encryption (KEK + DEK) and are never exposed in logs or standard API responses. Revealing secrets requires step-up re-authentication.",[856,7256,7258],{"id":7257},"what-encryption-standards-do-you-use","What encryption standards do you use?",[1581,7260,7261,7267,7273,7279],{},[1584,7262,7263,7266],{},[18,7264,7265],{},"Data at rest",": AES-256",[1584,7268,7269,7272],{},[18,7270,7271],{},"Data in transit",": TLS 1.3",[1584,7274,7275,7278],{},[18,7276,7277],{},"Card secrets",": Envelope encryption with periodic key rotation",[1584,7280,7281,7284],{},[18,7282,7283],{},"Webhook signatures",": HMAC-SHA256",[856,7286,7288],{"id":7287},"what-should-i-do-if-i-suspect-unauthorized-access","What should I do if I suspect unauthorized access?",[1641,7290,7291,7297,7300,7303],{},[1584,7292,7293,7294],{},"Immediately change your password via ",[18,7295,7296],{},"Account → Security",[1584,7298,7299],{},"Revoke all active sessions from the Security page",[1584,7301,7302],{},"Disable and re-enable TOTP to rotate your authenticator secret",[1584,7304,7305,7306],{},"Contact us at ",[18,7307,7308],{},[100,7309,7311],{"href":7310},"mailto:support@dotva.io","support@dotva.io",[23,7313],{},[26,7315,7317],{"id":7316},"contact-support","Contact & Support",[856,7319,7321],{"id":7320},"how-do-i-get-help","How do I get help?",[14,7323,7324,7325,7329],{},"Email ",[18,7326,7327],{},[100,7328,7311],{"href":7310}," for general inquiries, billing questions, and technical support.",[856,7331,7333],{"id":7332},"what-are-your-support-hours","What are your support hours?",[14,7335,7336],{},"Our support team operates on business days. We aim to respond to all inquiries within 1–2 business days.",{"title":295,"searchDepth":309,"depth":309,"links":7338},[7339,7344,7349,7360,7369,7374,7379,7386,7391],{"id":6792,"depth":309,"text":6793,"children":7340},[7341,7342,7343],{"id":6796,"depth":327,"text":6797},{"id":6803,"depth":327,"text":6804},{"id":6842,"depth":327,"text":6843},{"id":6851,"depth":309,"text":6852,"children":7345},[7346,7347,7348],{"id":6855,"depth":327,"text":6856},{"id":6868,"depth":327,"text":6869},{"id":6875,"depth":327,"text":6876},{"id":6884,"depth":309,"text":6885,"children":7350},[7351,7352,7353,7354,7355,7356,7357,7358],{"id":6888,"depth":327,"text":6889},{"id":6907,"depth":327,"text":6908},{"id":6919,"depth":327,"text":6920},{"id":6940,"depth":327,"text":6941},{"id":6951,"depth":327,"text":6952},{"id":6958,"depth":327,"text":6959},{"id":6969,"depth":327,"text":6970},{"id":7007,"depth":327,"text":7359},"What does a risk_blocked decline mean?",{"id":7024,"depth":309,"text":7025,"children":7361},[7362,7363,7364,7365,7366,7367,7368],{"id":7028,"depth":327,"text":7029},{"id":7035,"depth":327,"text":7036},{"id":7046,"depth":327,"text":7047},{"id":7056,"depth":327,"text":7057},{"id":7063,"depth":327,"text":7064},{"id":7070,"depth":327,"text":7071},{"id":7085,"depth":327,"text":7086},{"id":7105,"depth":309,"text":7106,"children":7370},[7371,7372,7373],{"id":7109,"depth":327,"text":7110},{"id":7120,"depth":327,"text":7121},{"id":7141,"depth":327,"text":7142},{"id":7154,"depth":309,"text":7155,"children":7375},[7376,7377,7378],{"id":7158,"depth":327,"text":7159},{"id":7165,"depth":327,"text":7166},{"id":7172,"depth":327,"text":7173},{"id":7181,"depth":309,"text":7182,"children":7380},[7381,7382,7383,7384,7385],{"id":7185,"depth":327,"text":7186},{"id":7197,"depth":327,"text":7198},{"id":7208,"depth":327,"text":7209},{"id":7215,"depth":327,"text":7216},{"id":7229,"depth":327,"text":7230},{"id":7246,"depth":309,"text":7247,"children":7387},[7388,7389,7390],{"id":7250,"depth":327,"text":7251},{"id":7257,"depth":327,"text":7258},{"id":7287,"depth":327,"text":7288},{"id":7316,"depth":309,"text":7317,"children":7392},[7393,7394],{"id":7320,"depth":327,"text":7321},{"id":7332,"depth":327,"text":7333},"faq","Common questions about Dotva's financial management system, virtual cards, workspace setup, deposits, and subscriptions.",{},"\u002Ffaq\u002Fgeneral",{"title":6784,"description":7396},"faq\u002F01.general","1_9OvWagcseUn4CMwawt3fYqICLbPPNQ2bjoqb9d0bI",{"id":7403,"title":7404,"body":7405,"category":7783,"description":7784,"extension":1525,"meta":7785,"navigation":1527,"order":302,"path":7786,"seo":7787,"stem":7788,"__hash__":7789},"content_en\u002Flegal\u002F01.service-agreement.md","User Service Agreement",{"type":7,"value":7406,"toc":7764},[7407,7410,7422,7425,7429,7473,7477,7480,7491,7495,7503,7507,7510,7513,7527,7530,7533,7537,7540,7543,7589,7592,7595,7598,7602,7605,7622,7625,7629,7632,7635,7638,7641,7644,7648,7651,7654,7657,7660,7664,7667,7671,7674,7678,7681,7695,7698,7701,7705,7708,7711,7714,7718,7721,7725,7732,7739,7743,7746,7750,7753,7757],[10,7408,7404],{"id":7409},"user-service-agreement",[14,7411,7412,7415,7416,7419,7415],{},[18,7413,7414],{},"Effective Date:"," June 18, 2026",[7417,7418],"br",{},[18,7420,7421],{},"Last Updated:",[14,7423,7424],{},"Welcome to Dotva. By registering an account and using our services, you agree to be bound by this User Service Agreement (\"Agreement\"). Please read it carefully before using the platform.",[26,7426,7428],{"id":7427},"_1-definitions","1. Definitions",[1581,7430,7431,7437,7443,7449,7455,7461,7467],{},[1584,7432,7433,7436],{},[18,7434,7435],{},"\"Dotva\""," refers to Dotva Inc., a company incorporated in the State of New York, United States, and the platform, services, and APIs it operates.",[1584,7438,7439,7442],{},[18,7440,7441],{},"\"User\""," refers to any individual or entity that registers an account on Dotva.",[1584,7444,7445,7448],{},[18,7446,7447],{},"\"Workspace\""," refers to the organizational unit within Dotva under which virtual cards, wallet funds, and team members are managed.",[1584,7450,7451,7454],{},[18,7452,7453],{},"\"Workspace Owner\""," refers to the User who created a Workspace and holds primary responsibility for all activities conducted within it.",[1584,7456,7457,7460],{},[18,7458,7459],{},"\"Virtual Card\""," refers to a Visa virtual card issued via Dotva's card issuer integration.",[1584,7462,7463,7466],{},[18,7464,7465],{},"\"Wallet\""," refers to the USD balance held within a Workspace.",[1584,7468,7469,7472],{},[18,7470,7471],{},"\"Staff\" and \"Delegate\""," refer to individuals invited by the Workspace Owner to access the Workspace with defined permissions.",[26,7474,7476],{"id":7475},"_2-eligibility","2. Eligibility",[14,7478,7479],{},"To use Dotva, you must:",[1581,7481,7482,7485,7488],{},[1584,7483,7484],{},"Be at least 18 years of age;",[1584,7486,7487],{},"Have the legal capacity to enter into this Agreement;",[1584,7489,7490],{},"Not be located in a jurisdiction where use of our services is prohibited under applicable law or OFAC sanctions.",[26,7492,7494],{"id":7493},"_3-account-registration","3. Account Registration",[14,7496,7497,7498,7502],{},"You agree to provide accurate, current, and complete information when creating your account. You are responsible for maintaining the confidentiality of your login credentials. Dotva is not liable for any unauthorized access resulting from your failure to safeguard your credentials. You must notify Dotva promptly at ",[18,7499,7500],{},[100,7501,7311],{"href":7310}," if you suspect unauthorized access.",[26,7504,7506],{"id":7505},"_4-workspace-owner-responsibility","4. Workspace Owner Responsibility",[14,7508,7509],{},"4.1 The Workspace Owner bears sole and full responsibility for all activities, transactions, and conduct occurring within their Workspace, regardless of whether such activities are carried out by the Workspace Owner, a Delegate, a Staff member, or any other party granted access to the Workspace.",[14,7511,7512],{},"4.2 The Workspace Owner is responsible for:",[1581,7514,7515,7518,7521,7524],{},[1584,7516,7517],{},"Ensuring that all Workspace members comply with this Agreement, the Risk Control Policy, and all applicable laws and regulations;",[1584,7519,7520],{},"Verifying the identity and authorization of any individual invited to the Workspace as Staff or Delegate;",[1584,7522,7523],{},"Monitoring card usage and spending within the Workspace;",[1584,7525,7526],{},"Promptly revoking access for members who no longer require it.",[14,7528,7529],{},"4.3 Any liabilities, financial penalties, losses, regulatory obligations, or legal consequences arising from activities conducted within a Workspace — including those caused by Staff members or Delegates — are the sole responsibility of the Workspace Owner. Dotva is not liable for the actions or omissions of Workspace members.",[14,7531,7532],{},"4.4 If a Workspace is used for any activity that violates this Agreement or applicable law, the Workspace Owner is liable for any resulting damages, fees, or penalties, including those imposed on Dotva by card networks, regulators, or third parties.",[26,7534,7536],{"id":7535},"_5-virtual-cards-and-fees","5. Virtual Cards and Fees",[14,7538,7539],{},"5.1 Virtual cards are issued via third-party card program providers. Dotva acts as a facilitator and is not a bank or financial institution.",[14,7541,7542],{},"5.2 The following fees apply to card and wallet operations:",[44,7544,7545,7555],{},[47,7546,7547],{},[50,7548,7549,7552],{},[53,7550,7551],{},"Operation",[53,7553,7554],{},"Fee",[63,7556,7557,7565,7573,7581],{},[50,7558,7559,7562],{},[68,7560,7561],{},"Card Issuance",[68,7563,7564],{},"USD 3.00 per card (deducted from initial top-up)",[50,7566,7567,7570],{},[68,7568,7569],{},"Card Top-up",[68,7571,7572],{},"3% of the top-up amount",[50,7574,7575,7578],{},[68,7576,7577],{},"USDT Deposit",[68,7579,7580],{},"USD 2.00 flat + 1% of the deposit amount",[50,7582,7583,7586],{},[68,7584,7585],{},"Withdrawal",[68,7587,7588],{},"56 TRX network gas fee (real-time USDT equivalent) + 1% + USD 5.00 service fee",[14,7590,7591],{},"Fees for individual card products may vary. Always review the product details before issuance.",[14,7593,7594],{},"5.3 All fees are deducted from the Workspace Wallet at the time of the operation.",[14,7596,7597],{},"5.4 Fees are non-refundable except where explicitly required by applicable law.",[26,7599,7601],{"id":7600},"_6-acceptable-use","6. Acceptable Use",[14,7603,7604],{},"You agree NOT to use Dotva for:",[1581,7606,7607,7610,7613,7616,7619],{},[1584,7608,7609],{},"Any illegal activities, including money laundering, fraud, or terrorist financing;",[1584,7611,7612],{},"Purchasing prohibited goods or services (see Risk Control Policy);",[1584,7614,7615],{},"Transactions with OFAC-sanctioned individuals, entities, or jurisdictions;",[1584,7617,7618],{},"Creating multiple accounts to circumvent platform restrictions;",[1584,7620,7621],{},"Accessing the platform through unauthorized automated means.",[14,7623,7624],{},"Violations may result in immediate account suspension and reporting to relevant authorities.",[26,7626,7628],{"id":7627},"_7-wallet-and-funds","7. Wallet and Funds",[14,7630,7631],{},"7.1 Funds in your Workspace Wallet are denominated in USD. USDT deposits are converted by our third-party payment partner at the prevailing exchange rate at the time of confirmation.",[14,7633,7634],{},"7.2 The minimum deposit amount is 200 USDT.",[14,7636,7637],{},"7.3 Dotva does not pay interest on Wallet balances.",[14,7639,7640],{},"7.4 Withdrawal requests are subject to compliance review and are processed within 7–15 business days. Dotva reserves the right to delay or refuse withdrawals if there is an active risk flag, outstanding fee obligation, or pending compliance matter.",[14,7642,7643],{},"7.5 Dotva is not a custodian or trustee of Wallet funds. Wallet balances are operational funds held for the purpose of funding card operations and are not protected by any deposit insurance scheme.",[26,7645,7647],{"id":7646},"_8-security","8. Security",[14,7649,7650],{},"8.1 You are responsible for enabling and maintaining two-factor authentication (TOTP) on your account.",[14,7652,7653],{},"8.2 You must immediately notify Dotva if you suspect unauthorized access to your account or Workspace.",[14,7655,7656],{},"8.3 All sensitive operations (card secret reveal, withdrawals) require step-up re-verification.",[14,7658,7659],{},"8.4 You are responsible for the security of any API tokens issued under your Developer subscription. Dotva is not liable for unauthorized API usage resulting from token exposure.",[26,7661,7663],{"id":7662},"_9-privacy","9. Privacy",[14,7665,7666],{},"Your use of Dotva is subject to our Privacy Policy, which is incorporated by reference into this Agreement.",[26,7668,7670],{"id":7669},"_10-intellectual-property","10. Intellectual Property",[14,7672,7673],{},"All platform software, designs, trademarks, and content are the exclusive property of Dotva Inc. You are granted a limited, non-exclusive, non-transferable, revocable license to use the platform solely for your internal business purposes. You may not copy, modify, distribute, or reverse-engineer any part of the platform.",[26,7675,7677],{"id":7676},"_11-termination","11. Termination",[14,7679,7680],{},"11.1 Dotva reserves the right to suspend or terminate any account or Workspace at any time for:",[1581,7682,7683,7686,7689,7692],{},[1584,7684,7685],{},"Violation of this Agreement or the Risk Control Policy;",[1584,7687,7688],{},"Suspicious activity or compliance concerns;",[1584,7690,7691],{},"Non-payment of platform fees or outstanding penalties;",[1584,7693,7694],{},"Request by a regulatory authority or card network.",[14,7696,7697],{},"11.2 Upon termination, remaining Wallet balances (minus any outstanding fees, penalties, and holds) will be returned to the Workspace Owner within a commercially reasonable time, subject to completion of any required compliance review.",[14,7699,7700],{},"11.3 Dotva is not liable to the Workspace Owner or any Workspace member for losses arising from account suspension or termination where the cause is a violation of this Agreement.",[26,7702,7704],{"id":7703},"_12-limitation-of-liability","12. Limitation of Liability",[14,7706,7707],{},"12.1 TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, DOTVA'S TOTAL LIABILITY TO YOU FOR ANY CLAIM ARISING FROM OR RELATED TO THIS AGREEMENT SHALL NOT EXCEED THE TOTAL FEES PAID BY YOU TO DOTVA IN THE THREE (3) MONTHS PRECEDING THE CLAIM.",[14,7709,7710],{},"12.2 DOTVA IS NOT LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, OR PUNITIVE DAMAGES, INCLUDING LOSS OF PROFITS, LOSS OF DATA, OR BUSINESS INTERRUPTION, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.",[14,7712,7713],{},"12.3 Dotva is not liable for delays, failures, or losses caused by third-party card issuers, payment networks, blockchain network congestion, or force majeure events beyond Dotva's reasonable control.",[26,7715,7717],{"id":7716},"_13-indemnification","13. Indemnification",[14,7719,7720],{},"You agree to indemnify, defend, and hold harmless Dotva Inc., its officers, directors, employees, and agents from and against any claims, liabilities, damages, losses, costs, and expenses (including reasonable legal fees) arising out of or related to: (i) your use of the platform; (ii) activities conducted within your Workspace; (iii) your violation of this Agreement or any applicable law; or (iv) any dispute between you and a third party.",[26,7722,7724],{"id":7723},"_14-governing-law-and-dispute-resolution","14. Governing Law and Dispute Resolution",[14,7726,7727,7728,7731],{},"14.1 This Agreement shall be governed by and construed in accordance with the laws of the ",[18,7729,7730],{},"State of New York, United States",", without regard to its conflict of law provisions.",[14,7733,7734,7735,7738],{},"14.2 Any dispute arising out of or relating to this Agreement shall be subject to the exclusive jurisdiction of the state and federal courts located in ",[18,7736,7737],{},"New York County, New York",". You hereby consent to personal jurisdiction and venue in such courts.",[26,7740,7742],{"id":7741},"_15-changes-to-this-agreement","15. Changes to This Agreement",[14,7744,7745],{},"Dotva may update this Agreement at any time. We will notify you of material changes via email or in-app notification at least 15 days before they take effect. Continued use of the platform after the effective date of any update constitutes your acceptance of the revised terms.",[26,7747,7749],{"id":7748},"_16-severability","16. Severability",[14,7751,7752],{},"If any provision of this Agreement is found to be unenforceable, the remaining provisions will continue in full force and effect.",[26,7754,7756],{"id":7755},"_17-contact","17. Contact",[14,7758,7759,7760],{},"For questions regarding this Agreement, contact us at: ",[18,7761,7762],{},[100,7763,7311],{"href":7310},{"title":295,"searchDepth":309,"depth":309,"links":7765},[7766,7767,7768,7769,7770,7771,7772,7773,7774,7775,7776,7777,7778,7779,7780,7781,7782],{"id":7427,"depth":309,"text":7428},{"id":7475,"depth":309,"text":7476},{"id":7493,"depth":309,"text":7494},{"id":7505,"depth":309,"text":7506},{"id":7535,"depth":309,"text":7536},{"id":7600,"depth":309,"text":7601},{"id":7627,"depth":309,"text":7628},{"id":7646,"depth":309,"text":7647},{"id":7662,"depth":309,"text":7663},{"id":7669,"depth":309,"text":7670},{"id":7676,"depth":309,"text":7677},{"id":7703,"depth":309,"text":7704},{"id":7716,"depth":309,"text":7717},{"id":7723,"depth":309,"text":7724},{"id":7741,"depth":309,"text":7742},{"id":7748,"depth":309,"text":7749},{"id":7755,"depth":309,"text":7756},"legal","Terms and conditions governing the use of Dotva financial management platform.",{},"\u002Flegal\u002Fservice-agreement",{"title":7404,"description":7784},"legal\u002F01.service-agreement","M_hzYHL0lGlHzwiL68WJv6aWTOO_zrpO-mwvxKL6T1w",{"id":7791,"title":7792,"body":7793,"category":7783,"description":8287,"extension":1525,"meta":8288,"navigation":1527,"order":309,"path":8289,"seo":8290,"stem":8291,"__hash__":8292},"content_en\u002Flegal\u002F02.privacy-policy.md","Privacy Policy",{"type":7,"value":7794,"toc":8261},[7795,7798,7806,7809,7811,7815,7819,7830,7834,7842,7846,7860,7864,7878,7882,7887,7890,7892,7896,7899,7922,7925,7927,7931,7935,7938,7942,7945,7949,7960,7964,7971,7975,7982,7984,7988,7991,8002,8005,8007,8011,8014,8059,8062,8064,8068,8122,8125,8127,8131,8134,8166,8172,8180,8182,8186,8189,8204,8207,8209,8213,8216,8218,8222,8230,8232,8236,8239,8241,8245,8248],[10,7796,7792],{"id":7797},"privacy-policy",[14,7799,7800,7415,7802,7804,7415],{},[18,7801,7414],{},[7417,7803],{},[18,7805,7421],{},[14,7807,7808],{},"Dotva Inc. (\"Dotva\", \"we\", \"us\", \"our\") is a company incorporated in the State of New York, United States. We are committed to protecting your privacy and handling your personal information responsibly. This Privacy Policy describes how we collect, use, disclose, and safeguard information when you use the Dotva platform, and explains your rights under applicable law.",[23,7810],{},[26,7812,7814],{"id":7813},"_1-information-we-collect","1. Information We Collect",[856,7816,7818],{"id":7817},"_11-account-information","1.1 Account Information",[1581,7820,7821,7824,7827],{},[1584,7822,7823],{},"Full name and email address",[1584,7825,7826],{},"Password (stored as a bcrypt hash — never in plaintext)",[1584,7828,7829],{},"Workspace name and slug",[856,7831,7833],{"id":7832},"_12-identity-information","1.2 Identity Information",[1581,7835,7836,7839],{},[1584,7837,7838],{},"Cardholder names associated with virtual cards (first name and last name)",[1584,7840,7841],{},"Billing address provided for card issuance",[856,7843,7845],{"id":7844},"_13-financial-information","1.3 Financial Information",[1581,7847,7848,7851,7854,7857],{},[1584,7849,7850],{},"USDT wallet addresses used for deposits",[1584,7852,7853],{},"Transaction amounts, merchant names, and transaction metadata",[1584,7855,7856],{},"Ledger entries and wallet balance history",[1584,7858,7859],{},"Subscription and fee records",[856,7861,7863],{"id":7862},"_14-technical-information","1.4 Technical Information",[1581,7865,7866,7869,7872,7875],{},[1584,7867,7868],{},"IP address at login and during sensitive operations",[1584,7870,7871],{},"Browser user agent",[1584,7873,7874],{},"Session timestamps and duration",[1584,7876,7877],{},"API request logs (used for rate limiting and security monitoring)",[856,7879,7881],{"id":7880},"_15-communications","1.5 Communications",[1581,7883,7884],{},[1584,7885,7886],{},"Support ticket messages and email correspondence with our team",[14,7888,7889],{},"We do not collect Social Security Numbers, government-issued ID numbers, or biometric data unless specifically required for a compliance verification process, in which case we will notify you separately.",[23,7891],{},[26,7893,7895],{"id":7894},"_2-how-we-use-your-information","2. How We Use Your Information",[14,7897,7898],{},"We use collected information to:",[1581,7900,7901,7904,7907,7910,7913,7916,7919],{},[1584,7902,7903],{},"Provide, operate, and maintain the Dotva platform and services;",[1584,7905,7906],{},"Process virtual card issuance and transactions;",[1584,7908,7909],{},"Verify identity for account security and step-up authentication;",[1584,7911,7912],{},"Detect, investigate, and prevent fraud, abuse, and suspicious activity;",[1584,7914,7915],{},"Comply with legal, regulatory, and card network obligations (including AML, OFAC, BSA, and GLBA);",[1584,7917,7918],{},"Send service notifications, security alerts, and billing communications;",[1584,7920,7921],{},"Improve platform reliability, performance, and security.",[14,7923,7924],{},"We do not use your information for advertising or sell it to third parties.",[23,7926],{},[26,7928,7930],{"id":7929},"_3-data-storage-and-security","3. Data Storage and Security",[856,7932,7934],{"id":7933},"_31-encryption-at-rest","3.1 Encryption at Rest",[14,7936,7937],{},"All sensitive data is encrypted at rest using AES-256. Virtual card secrets (PAN, CVV, expiry) are protected using Envelope Encryption (KEK + DEK architecture) and are never stored in plaintext.",[856,7939,7941],{"id":7940},"_32-encryption-in-transit","3.2 Encryption in Transit",[14,7943,7944],{},"All data in transit is protected by TLS 1.3. Connections using older or deprecated protocols are rejected.",[856,7946,7948],{"id":7947},"_33-access-controls","3.3 Access Controls",[1581,7950,7951,7954,7957],{},[1584,7952,7953],{},"Internal access to production data is role-restricted and audit-logged.",[1584,7955,7956],{},"Administrative portal access is restricted to authorized personnel via IP allowlist.",[1584,7958,7959],{},"Step-up authentication is required for all sensitive internal operations.",[856,7961,7963],{"id":7962},"_34-cybersecurity-program","3.4 Cybersecurity Program",[14,7965,7966,7967,7970],{},"In compliance with the ",[18,7968,7969],{},"New York SHIELD Act"," (NY General Business Law § 899-bb), Dotva maintains a written cybersecurity program that includes reasonable administrative, technical, and physical safeguards appropriate to the size and complexity of our operations and the sensitivity of the personal information we hold.",[856,7972,7974],{"id":7973},"_35-data-location","3.5 Data Location",[14,7976,7977,7978,7981],{},"Your data is stored on servers located in the ",[18,7979,7980],{},"United States",". We do not transfer personal data outside the United States without ensuring appropriate contractual or regulatory safeguards are in place.",[23,7983],{},[26,7985,7987],{"id":7986},"_4-data-breach-notification","4. Data Breach Notification",[14,7989,7990],{},"In the event of a security breach affecting \"private information\" as defined under the New York SHIELD Act, Dotva will:",[1581,7992,7993,7996,7999],{},[1584,7994,7995],{},"Notify affected New York residents in the most expedient time possible and without unreasonable delay;",[1584,7997,7998],{},"Notify the New York Attorney General, the Department of State, and the Division of State Police as required by law;",[1584,8000,8001],{},"Provide notification to other affected users in accordance with the laws of their respective states or jurisdictions.",[14,8003,8004],{},"Notification will be delivered by email to the address on file, or by substitute notice if direct notification is not reasonably feasible.",[23,8006],{},[26,8008,8010],{"id":8009},"_5-data-sharing","5. Data Sharing",[14,8012,8013],{},"We do not sell your personal information. We share data only in the following circumstances:",[44,8015,8016,8025],{},[47,8017,8018],{},[50,8019,8020,8023],{},[53,8021,8022],{},"Recipient",[53,8024,1588],{},[63,8026,8027,8035,8043,8051],{},[50,8028,8029,8032],{},[68,8030,8031],{},"Card Issuer",[68,8033,8034],{},"Required to issue, manage, and process virtual card transactions",[50,8036,8037,8040],{},[68,8038,8039],{},"Payment Network (Visa)",[68,8041,8042],{},"Card authorization and settlement",[50,8044,8045,8048],{},[68,8046,8047],{},"USDT Processing Partner",[68,8049,8050],{},"Blockchain deposit confirmation and USDT-to-USD conversion",[50,8052,8053,8056],{},[68,8054,8055],{},"Legal and regulatory authorities",[68,8057,8058],{},"When required by applicable law, court order, or lawful government request",[14,8060,8061],{},"All third-party service providers are contractually required to handle personal information in a manner consistent with this policy.",[23,8063],{},[26,8065,8067],{"id":8066},"_6-data-retention","6. Data Retention",[44,8069,8070,8080],{},[47,8071,8072],{},[50,8073,8074,8077],{},[53,8075,8076],{},"Data Type",[53,8078,8079],{},"Retention Period",[63,8081,8082,8090,8098,8106,8114],{},[50,8083,8084,8087],{},[68,8085,8086],{},"Account information",[68,8088,8089],{},"Duration of account + 7 years after closure",[50,8091,8092,8095],{},[68,8093,8094],{},"Transaction and financial records",[68,8096,8097],{},"7 years (required by financial regulations including BSA)",[50,8099,8100,8103],{},[68,8101,8102],{},"Audit and security logs",[68,8104,8105],{},"5 years",[50,8107,8108,8111],{},[68,8109,8110],{},"API request logs",[68,8112,8113],{},"90 days",[50,8115,8116,8119],{},[68,8117,8118],{},"Support tickets",[68,8120,8121],{},"3 years",[14,8123,8124],{},"We may be required to retain certain financial records beyond these periods pursuant to applicable law. Retention obligations will take precedence over any deletion requests.",[23,8126],{},[26,8128,8130],{"id":8129},"_7-your-rights","7. Your Rights",[14,8132,8133],{},"Depending on your jurisdiction, you may have the right to:",[1581,8135,8136,8142,8148,8154,8160],{},[1584,8137,8138,8141],{},[18,8139,8140],{},"Access"," — request a copy of the personal data we hold about you;",[1584,8143,8144,8147],{},[18,8145,8146],{},"Correction"," — request correction of inaccurate or incomplete information;",[1584,8149,8150,8153],{},[18,8151,8152],{},"Deletion"," — request deletion of your account and associated personal data, subject to legal retention obligations;",[1584,8155,8156,8159],{},[18,8157,8158],{},"Portability"," — receive your data in a structured, machine-readable format;",[1584,8161,8162,8165],{},[18,8163,8164],{},"Objection"," — object to certain processing activities.",[14,8167,8168,8171],{},[18,8169,8170],{},"New York residents"," are entitled to the protections afforded by the NY SHIELD Act, including the right to be notified of data breaches affecting their private information.",[14,8173,8174,8175,8179],{},"To exercise any of these rights, contact us at ",[18,8176,8177],{},[100,8178,7311],{"href":7310},". We will respond within 30 days of receiving a verifiable request.",[23,8181],{},[26,8183,8185],{"id":8184},"_8-cookies-and-local-storage","8. Cookies and Local Storage",[14,8187,8188],{},"Dotva uses minimal browser storage:",[1581,8190,8191,8197],{},[1584,8192,8193,8196],{},[30,8194,8195],{},"dotva_locale"," — stores your language preference (cookie, 1 year)",[1584,8198,8199,8200,8203],{},"Authentication session token — stored in ",[30,8201,8202],{},"localStorage",", not a cookie, expires with your session",[14,8205,8206],{},"We do not use third-party tracking cookies, advertising pixels, or behavioral analytics tools.",[23,8208],{},[26,8210,8212],{"id":8211},"_9-childrens-privacy","9. Children's Privacy",[14,8214,8215],{},"Dotva is not directed to individuals under 18 years of age. We do not knowingly collect personal information from minors. If we become aware that we have inadvertently collected information from a minor, we will delete it promptly.",[23,8217],{},[26,8219,8221],{"id":8220},"_10-california-and-other-state-residents","10. California and Other State Residents",[14,8223,8224,8225,8229],{},"While Dotva is incorporated in New York, we respect the privacy rights of residents of other U.S. states. If you are a California resident, you may have additional rights under the California Consumer Privacy Act (CCPA). Please contact us at ",[18,8226,8227],{},[100,8228,7311],{"href":7310}," to submit a request.",[23,8231],{},[26,8233,8235],{"id":8234},"_11-changes-to-this-policy","11. Changes to This Policy",[14,8237,8238],{},"We will notify you of material changes to this Privacy Policy via email or in-app notice at least 14 days before the change takes effect. The \"Last Updated\" date at the top of this document will always reflect the most recent revision.",[23,8240],{},[26,8242,8244],{"id":8243},"_12-contact","12. Contact",[14,8246,8247],{},"For privacy-related inquiries or to exercise your rights:",[14,8249,8250,3866,8253,8255,8257,8260],{},[18,8251,8252],{},"Email:",[100,8254,7311],{"href":7310},[7417,8256],{},[18,8258,8259],{},"Data Controller:"," Dotva Inc., New York, NY, United States",{"title":295,"searchDepth":309,"depth":309,"links":8262},[8263,8270,8271,8278,8279,8280,8281,8282,8283,8284,8285,8286],{"id":7813,"depth":309,"text":7814,"children":8264},[8265,8266,8267,8268,8269],{"id":7817,"depth":327,"text":7818},{"id":7832,"depth":327,"text":7833},{"id":7844,"depth":327,"text":7845},{"id":7862,"depth":327,"text":7863},{"id":7880,"depth":327,"text":7881},{"id":7894,"depth":309,"text":7895},{"id":7929,"depth":309,"text":7930,"children":8272},[8273,8274,8275,8276,8277],{"id":7933,"depth":327,"text":7934},{"id":7940,"depth":327,"text":7941},{"id":7947,"depth":327,"text":7948},{"id":7962,"depth":327,"text":7963},{"id":7973,"depth":327,"text":7974},{"id":7986,"depth":309,"text":7987},{"id":8009,"depth":309,"text":8010},{"id":8066,"depth":309,"text":8067},{"id":8129,"depth":309,"text":8130},{"id":8184,"depth":309,"text":8185},{"id":8211,"depth":309,"text":8212},{"id":8220,"depth":309,"text":8221},{"id":8234,"depth":309,"text":8235},{"id":8243,"depth":309,"text":8244},"How Dotva collects, uses, and protects your personal information, in compliance with New York State law.",{},"\u002Flegal\u002Fprivacy-policy",{"title":7792,"description":8287},"legal\u002F02.privacy-policy","gCdOTaM1RRYg24YHqm9FjZMto0IYAK7-Pvoza59qVrU",{"id":8294,"title":7018,"body":8295,"category":8809,"description":8810,"extension":1525,"meta":8811,"navigation":1527,"order":302,"path":8812,"seo":8813,"stem":8814,"__hash__":8815},"content_en\u002Frisk\u002F01.risk-policy.md",{"type":7,"value":8296,"toc":8789},[8297,8300,8304,8307,8309,8313,8316,8320,8334,8338,8352,8356,8364,8368,8379,8381,8385,8388,8458,8461,8463,8467,8470,8474,8494,8498,8532,8536,8583,8587,8593,8599,8605,8607,8611,8616,8619,8657,8660,8670,8677,8679,8683,8686,8714,8717,8719,8723,8726,8764,8767,8769,8773,8776,8778,8782],[10,8298,7018],{"id":8299},"risk-control-policy",[14,8301,8302,7415],{},[18,8303,7414],{},[14,8305,8306],{},"Dotva is a financial management platform. As part of that service, we provide virtual cards as a spending instrument for teams and organizations. Like all financial tools, their use is subject to card network rules, issuer requirements, and applicable regulations. This policy describes the risk controls that govern how these tools may be used and what happens when violations occur.",[23,8308],{},[26,8310,8312],{"id":8311},"_1-prohibited-activities","1. Prohibited Activities",[14,8314,8315],{},"The following activities are strictly prohibited when using Dotva's financial tools:",[856,8317,8319],{"id":8318},"illegal-transactions","Illegal Transactions",[1581,8321,8322,8325,8328,8331],{},[1584,8323,8324],{},"Money laundering",[1584,8326,8327],{},"Terrorism financing",[1584,8329,8330],{},"Fraudulent activities",[1584,8332,8333],{},"Any transaction that violates local or international law",[856,8335,8337],{"id":8336},"platform-abuse","Platform Abuse",[1581,8339,8340,8343,8346,8349],{},[1584,8341,8342],{},"Attempting to bypass our security measures",[1584,8344,8345],{},"Creating multiple accounts to circumvent restrictions",[1584,8347,8348],{},"Exploiting system vulnerabilities",[1584,8350,8351],{},"Any activity that may compromise the integrity of our platform",[856,8353,8355],{"id":8354},"merchant-abuse","Merchant Abuse",[1581,8357,8358,8361],{},[1584,8359,8360],{},"Unauthorized transactions",[1584,8362,8363],{},"Any activity that may harm our merchant partners",[856,8365,8367],{"id":8366},"card-network-violations","Card Network Violations",[1581,8369,8370,8373,8376],{},[1584,8371,8372],{},"Violating card network rules and regulations",[1584,8374,8375],{},"Circumventing card network security measures",[1584,8377,8378],{},"Abusing card network services",[23,8380],{},[26,8382,8384],{"id":8383},"_2-prohibited-merchant-categories-mcc","2. Prohibited Merchant Categories (MCC)",[14,8386,8387],{},"Virtual cards issued via Dotva may not be used at merchants in the following categories:",[44,8389,8390,8400],{},[47,8391,8392],{},[50,8393,8394,8397],{},[53,8395,8396],{},"Category",[53,8398,8399],{},"Examples",[63,8401,8402,8410,8418,8426,8434,8442,8450],{},[50,8403,8404,8407],{},[68,8405,8406],{},"Gambling \u002F Betting",[68,8408,8409],{},"Online casinos, sports betting, lottery",[50,8411,8412,8415],{},[68,8413,8414],{},"Adult Content",[68,8416,8417],{},"Adult entertainment platforms",[50,8419,8420,8423],{},[68,8421,8422],{},"Cryptocurrency Exchanges",[68,8424,8425],{},"Direct crypto purchase via card",[50,8427,8428,8431],{},[68,8429,8430],{},"Money Services",[68,8432,8433],{},"Unlicensed money transfer operators",[50,8435,8436,8439],{},[68,8437,8438],{},"Weapons",[68,8440,8441],{},"Firearms and ammunition dealers",[50,8443,8444,8447],{},[68,8445,8446],{},"Controlled Substances",[68,8448,8449],{},"Non-licensed pharmaceutical, illicit markets",[50,8451,8452,8455],{},[68,8453,8454],{},"Sanctioned Entities",[68,8456,8457],{},"OFAC-listed merchants or countries",[14,8459,8460],{},"Transactions at prohibited merchant categories are subject to compliance review. Repeated violations may result in card closure and account termination.",[23,8462],{},[26,8464,8466],{"id":8465},"_3-automated-risk-rules","3. Automated Risk Rules",[14,8468,8469],{},"Dotva's risk engine evaluates every card transaction in real time. The rules below are active on all accounts as of the effective date above. Thresholds are managed by Dotva and may be adjusted without notice.",[856,8471,8473],{"id":8472},"how-it-works","How it works",[1581,8475,8476,8482,8488],{},[1584,8477,8478,8481],{},[18,8479,8480],{},"Real-time evaluation"," — every transaction, including $0 pre-authorizations, triggers a rule check.",[1584,8483,8484,8487],{},[18,8485,8486],{},"Post-transaction enforcement"," — our engine acts on subsequent transactions after a rule fires; it cannot reverse the transaction that triggered it.",[1584,8489,8490,8493],{},[18,8491,8492],{},"Independent rules"," — each rule evaluates separately; when multiple rules fire simultaneously, the strongest action applies.",[856,8495,8497],{"id":8496},"enforcement-actions","Enforcement actions",[44,8499,8500,8510],{},[47,8501,8502],{},[50,8503,8504,8507],{},[53,8505,8506],{},"Action",[53,8508,8509],{},"Effect",[63,8511,8512,8522],{},[50,8513,8514,8519],{},[68,8515,8516],{},[18,8517,8518],{},"Card Closure",[68,8520,8521],{},"Card enters a pending-close state and is permanently closed after settlement (approx. 24 hours). This action is irreversible.",[50,8523,8524,8529],{},[68,8525,8526],{},[18,8527,8528],{},"Penalty Fee",[68,8530,8531],{},"$0.15 deducted from the workspace wallet per triggering event. The balance may go negative; transactions are blocked until the shortfall is cleared.",[856,8533,8535],{"id":8534},"active-rules-effective-june-18-2026","Active rules (effective June 18, 2026)",[44,8537,8538,8550],{},[47,8539,8540],{},[50,8541,8542,8545,8548],{},[53,8543,8544],{},"Rule",[53,8546,8547],{},"Triggers",[53,8549,8506],{},[63,8551,8552,8562,8573],{},[50,8553,8554,8557,8560],{},[68,8555,8556],{},"Consecutive transaction failures",[68,8558,8559],{},"10 consecutive declined transactions on a single card",[68,8561,8518],{},[50,8563,8564,8567,8570],{},[68,8565,8566],{},"Failed transaction penalty fee",[68,8568,8569],{},"Any declined transaction — assessed per occurrence with no minimum threshold",[68,8571,8572],{},"Penalty ($0.15)",[50,8574,8575,8578,8581],{},[68,8576,8577],{},"Blacklisted merchant",[68,8579,8580],{},"Transaction resolved to a merchant flagged for over-settlement risk",[68,8582,8518],{},[856,8584,8586],{"id":8585},"rule-notes","Rule notes",[14,8588,8589,8592],{},[18,8590,8591],{},"Consecutive failures:"," The failure counter resets upon any successful authorization, settlement, or refund. Occasional declines during normal use will not trigger card closure. The per-decline penalty fee is the primary deterrent; closure is a last resort for cards that sustain prolonged failure without corrective action.",[14,8594,8595,8598],{},[18,8596,8597],{},"Post-closure penalty fees:"," Even after a card is closed, delayed or force-posted charges from merchants continue to incur the $0.15 fee until the card is removed from the merchant's billing system. The only way to stop recurring charges is to cancel the subscription or remove the card directly with the merchant.",[14,8600,8601,8604],{},[18,8602,8603],{},"Blacklisted merchants:"," Certain merchants are known to settle amounts exceeding the original authorization. Cards used at these merchants are closed upon the first transaction as a protective measure. Contact support if you believe a merchant has been incorrectly classified.",[23,8606],{},[26,8608,8610],{"id":8609},"_4-withdrawal-policy","4. Withdrawal Policy",[14,8612,8613,8614,265],{},"4.1 Withdrawal requests are processed manually by Dotva compliance staff within ",[18,8615,7081],{},[14,8617,8618],{},"4.2 Withdrawal fees:",[44,8620,8621,8631],{},[47,8622,8623],{},[50,8624,8625,8628],{},[53,8626,8627],{},"Fee component",[53,8629,8630],{},"Amount",[63,8632,8633,8641,8649],{},[50,8634,8635,8638],{},[68,8636,8637],{},"Network gas fee",[68,8639,8640],{},"56 TRX (converted to USDT at the real-time exchange rate at time of processing)",[50,8642,8643,8646],{},[68,8644,8645],{},"Service fee",[68,8647,8648],{},"$5.00 USD",[50,8650,8651,8654],{},[68,8652,8653],{},"Percentage fee",[68,8655,8656],{},"1% of the withdrawal amount",[14,8658,8659],{},"4.3 Withdrawals may be delayed or refused if:",[1581,8661,8662,8665,8668],{},[1584,8663,8664],{},"The workspace has active risk flags or a pending compliance review",[1584,8666,8667],{},"There are outstanding fee obligations (including a negative wallet balance)",[1584,8669,7100],{},[14,8671,8672,8673,8676],{},"4.4 Withdrawals are processed in USDT to the address specified in the request. Only ",[18,8674,8675],{},"one pending withdrawal request"," is allowed per workspace at a time.",[23,8678],{},[26,8680,8682],{"id":8681},"_5-regulatory-compliance","5. Regulatory Compliance",[14,8684,8685],{},"Our platform strictly adheres to applicable financial regulations, including but not limited to:",[1581,8687,8688,8693,8698,8703,8708],{},[1584,8689,8690],{},[18,8691,8692],{},"Bank Secrecy Act (BSA)",[1584,8694,8695],{},[18,8696,8697],{},"Anti-Money Laundering (AML) regulations",[1584,8699,8700],{},[18,8701,8702],{},"Office of Foreign Assets Control (OFAC) sanctions",[1584,8704,8705],{},[18,8706,8707],{},"Payment Card Industry Data Security Standard (PCI DSS)",[1584,8709,8710,8713],{},[18,8711,8712],{},"Card network rules"," (Visa program requirements)",[14,8715,8716],{},"Dotva may be legally required to report transactions to relevant authorities, including Financial Intelligence Units (FIU), tax authorities, and law enforcement when served with valid legal process. We will notify affected users of legal disclosures where permitted by law.",[23,8718],{},[26,8720,8722],{"id":8721},"_6-enforcement-actions","6. Enforcement Actions",[14,8724,8725],{},"Violations of this policy will result in immediate action, including one or more of the following:",[1581,8727,8728,8734,8740,8746,8752,8758],{},[1584,8729,8730,8733],{},[18,8731,8732],{},"Account suspension"," — platform access is restricted pending investigation",[1584,8735,8736,8739],{},[18,8737,8738],{},"Freezing of associated funds"," — wallet balance is held until the investigation concludes",[1584,8741,8742,8745],{},[18,8743,8744],{},"Investigation of suspicious activity"," — our compliance team will review the account",[1584,8747,8748,8751],{},[18,8749,8750],{},"Financial penalties"," — fees assessed per Section 3",[1584,8753,8754,8757],{},[18,8755,8756],{},"Recovery of financial losses"," — Dotva reserves the right to recover losses caused by policy violations",[1584,8759,8760,8763],{},[18,8761,8762],{},"Additional penalties for repeat violations"," — escalating consequences for continued non-compliance",[14,8765,8766],{},"Suspended accounts retain their wallet balance. Funds will be returned (minus outstanding fees and penalties) after the investigation is complete.",[23,8768],{},[26,8770,8772],{"id":8771},"_7-updates-to-this-policy","7. Updates to This Policy",[14,8774,8775],{},"Dotva reserves the right to update this policy as required by regulatory changes or card network rule updates. Material changes will be communicated with 30 days' notice where possible. Automated risk rule thresholds may be adjusted at any time without prior notice.",[23,8777],{},[26,8779,8781],{"id":8780},"_8-contact","8. Contact",[14,8783,8784,8785],{},"For risk, compliance, and support inquiries: ",[18,8786,8787],{},[100,8788,7311],{"href":7310},{"title":295,"searchDepth":309,"depth":309,"links":8790},[8791,8797,8798,8804,8805,8806,8807,8808],{"id":8311,"depth":309,"text":8312,"children":8792},[8793,8794,8795,8796],{"id":8318,"depth":327,"text":8319},{"id":8336,"depth":327,"text":8337},{"id":8354,"depth":327,"text":8355},{"id":8366,"depth":327,"text":8367},{"id":8383,"depth":309,"text":8384},{"id":8465,"depth":309,"text":8466,"children":8799},[8800,8801,8802,8803],{"id":8472,"depth":327,"text":8473},{"id":8496,"depth":327,"text":8497},{"id":8534,"depth":327,"text":8535},{"id":8585,"depth":327,"text":8586},{"id":8609,"depth":309,"text":8610},{"id":8681,"depth":309,"text":8682},{"id":8721,"depth":309,"text":8722},{"id":8771,"depth":309,"text":8772},{"id":8780,"depth":309,"text":8781},"risk","Prohibited activities, transaction monitoring rules, regulatory compliance, and enforcement actions for Dotva financial tools.",{},"\u002Frisk\u002Frisk-policy",{"title":7018,"description":8810},"risk\u002F01.risk-policy","ohPsN4ywYv5c8LjUmVLo-Me7ue4BWRJq3zdOGt79hqQ",1782383066078]