ull,{"stroke":"currentColor","fill":"currentColor","strokeWidth":"0","viewBox":"0 0 384 512","color":"$undefined","className":"$undefined","style":{"color":"$undefined"},"aria-hidden":true,"children":["$undefined",[["$","path","0",{"d":"M16 64C16 28.7 44.7 0 80 0L304 0c35.3 0 64 28.7 64 64l0 384c0 35.3-28.7 64-64 64L80 512c-35.3 0-64-28.7-64-64L16 64zM224 448a32 32 0 1 0 -64 0 32 32 0 1 0 64 0zM304 64L80 64l0 320 224 0 0-320z","children":[]}]]],"height":"1em","width":"1em","xmlns":"http://www.w3.org/2000/svg"}] 16:["$","svg",null,{"stroke":"currentColor","fill":"currentColor","strokeWidth":"0","viewBox":"0 0 640 512","color":"$undefined","className":"$undefined","style":{"color":"$undefined"},"aria-hidden":true,"children":["$undefined",[["$","path","0",{"d":"M392.8 1.2c-17-4.9-34.7 5-39.6 22l-128 448c-4.9 17 5 34.7 22 39.6s34.7-5 39.6-22l128-448c4.9-17-5-34.7-22-39.6zm80.6 120.1c-12.5 12.5-12.5 32.8 0 45.3L562.7 256l-89.4 89.4c-12.5 12.5-12.5 32.8 0 45.3s32.8 12.5 45.3 0l112-112c12.5-12.5 12.5-32.8 0-45.3l-112-112c-12.5-12.5-32.8-12.5-45.3 0zm-306.7 0c-12.5-12.5-32.8-12.5-45.3 0l-112 112c-12.5 12.5-12.5 32.8 0 45.3l112 112c12.5 12.5 32.8 12.5 45.3 0s12.5-32.8 0-45.3L77.3 256l89.4-89.4c12.5-12.5 12.5-32.8 0-45.3z","children":[]}]]],"height":"1em","width":"1em","xmlns":"http://www.w3.org/2000/svg"}] 17:["$","svg",null,{"stroke":"currentColor","fill":"currentColor","strokeWidth":"0","viewBox":"0 0 576 512","color":"$undefined","className":"$undefined","style":{"color":"$undefined"},"aria-hidden":true,"children":["$undefined",[["$","path","0",{"d":"M264.5 5.2c14.9-6.9 32.1-6.9 47 0l218.6 101c8.5 3.9 13.9 12.4 13.9 21.8s-5.4 17.9-13.9 21.8l-218.6 101c-14.9 6.9-32.1 6.9-47 0L45.9 149.8C37.4 145.8 32 137.3 32 128s5.4-17.9 13.9-21.8L264.5 5.2zM476.9 209.6l53.2 24.6c8.5 3.9 13.9 12.4 13.9 21.8s-5.4 17.9-13.9 21.8l-218.6 101c-14.9 6.9-32.1 6.9-47 0L45.9 277.8C37.4 273.8 32 265.3 32 256s5.4-17.9 13.9-21.8l53.2-24.6 152 70.2c23.4 10.8 50.4 10.8 73.8 0l152-70.2zm-152 198.2l152-70.2 53.2 24.6c8.5 3.9 13.9 12.4 13.9 21.8s-5.4 17.9-13.9 21.8l-218.6 101c-14.9 6.9-32.1 6.9-47 0L45.9 405.8C37.4 401.8 32 393.3 32 384s5.4-17.9 13.9-21.8l53.2-24.6 152 70.2c23.4 10.8 50.4 10.8 73.8 0z","children":[]}]]],"height":"1em","width":"1em","xmlns":"http://www.w3.org/2000/svg"}] 18:["$","svg",null,{"stroke":"currentColor","fill":"currentColor","strokeWidth":"0","viewBox":"0 0 512 512","color":"$undefined","className":"$undefined","style":{"color":"$undefined"},"aria-hidden":true,"children":["$undefined",[["$","path","0",{"d":"M352 256c0 22.2-1.2 43.6-3.3 64l-185.3 0c-2.2-20.4-3.3-41.8-3.3-64s1.2-43.6 3.3-64l185.3 0c2.2 20.4 3.3 41.8 3.3 64zm28.8-64l123.1 0c5.3 20.5 8.1 41.9 8.1 64s-2.8 43.5-8.1 64l-123.1 0c2.1-20.6 3.2-42 3.2-64s-1.1-43.4-3.2-64zm112.6-32l-116.7 0c-10-63.9-29.8-117.4-55.3-151.6c78.3 20.7 142 77.5 171.9 151.6zm-149.1 0l-176.6 0c6.1-36.4 15.5-68.6 27-94.7c10.5-23.6 22.2-40.7 33.5-51.5C239.4 3.2 248.7 0 256 0s16.6 3.2 27.8 13.8c11.3 10.8 23 27.9 33.5 51.5c11.6 26 20.9 58.2 27 94.7zm-209 0L18.6 160C48.6 85.9 112.2 29.1 190.6 8.4C165.1 42.6 145.3 96.1 135.3 160zM8.1 192l123.1 0c-2.1 20.6-3.2 42-3.2 64s1.1 43.4 3.2 64L8.1 320C2.8 299.5 0 278.1 0 256s2.8-43.5 8.1-64zM194.7 446.6c-11.6-26-20.9-58.2-27-94.6l176.6 0c-6.1 36.4-15.5 68.6-27 94.6c-10.5 23.6-22.2 40.7-33.5 51.5C272.6 508.8 263.3 512 256 512s-16.6-3.2-27.8-13.8c-11.3-10.8-23-27.9-33.5-51.5zM135.3 352c10 63.9 29.8 117.4 55.3 151.6C112.2 482.9 48.6 426.1 18.6 352l116.7 0zm358.1 0c-30 74.1-93.6 130.9-171.9 151.6c25.5-34.2 45.2-87.7 55.3-151.6l116.7 0z","children":[]}]]],"height":"1em","width":"1em","xmlns":"http://www.w3.org/2000/svg"}] 19:["$","svg",null,{"stroke":"currentColor","fill":"currentColor","strokeWidth":"0","viewBox":"0 0 576 512","color":"$undefined","className":"$undefined","style":{"color":"$undefined"},"aria-hidden":true,"children":["$undefined",[["$","path","0",{"d":"M64 32C28.7 32 0 60.7 0 96l0 32 576 0 0-32c0-35.3-28.7-64-64-64L64 32zM576 224L0 224 0 416c0 35.3 28.7 64 64 64l448 0c35.3 0 64-28.7 64-64l0-192zM112 352l64 0c8.8 0 16 7.2 16 16s-7.2 16-16 16l-64 0c-8.8 0-16-7.2-16-16s7.2-16 16-16zm112 16c0-8.8 7.2-16 16-16l128 0c8.8 0 16 7.2 16 16s-7.2 16-16 16l-128 0c-8.8 0-16-7.2-16-16z","children":[]}]]],"height":"1em","width":"1em","xmlns":"http://www.w3.org/2000/svg"}] 1a:["$","svg",null,{"stroke":"currentColor","fill":"none","strokeWidth":"2","viewBox":"0 0 24 24","strokeLinecap":"round","strokeLinejoin":"round","color":"$undefined","className":"$undefined","style":{"color":"$undefined"},"aria-hidden":true,"children":["$undefined",[["$","path","0",{"d":"M20 13c0 5-3.5 7.5-7.66 8.95a1 1 0 0 1-.67-.01C7.5 20.5 4 18 4 13V6a1 1 0 0 1 1-1c2 0 4.5-1.2 6.24-2.72a1.17 1.17 0 0 1 1.52 0C14.51 3.81 17 5 19 5a1 1 0 0 1 1 1z","children":[]}],["$","path","1",{"d":"m9 12 2 2 4-4","children":[]}]]],"height":"1em","width":"1em","xmlns":"http://www.w3.org/2000/svg"}] 1b:["$","svg",null,{"stroke":"currentColor","fill":"currentColor","strokeWidth":"0","viewBox":"0 0 640 512","color":"$undefined","className":"$undefined","style":{"color":"$undefined"},"aria-hidden":true,"children":["$undefined",[["$","path","0",{"d":"M392.8 1.2c-17-4.9-34.7 5-39.6 22l-128 448c-4.9 17 5 34.7 22 39.6s34.7-5 39.6-22l128-448c4.9-17-5-34.7-22-39.6zm80.6 120.1c-12.5 12.5-12.5 32.8 0 45.3L562.7 256l-89.4 89.4c-12.5 12.5-12.5 32.8 0 45.3s32.8 12.5 45.3 0l112-112c12.5-12.5 12.5-32.8 0-45.3l-112-112c-12.5-12.5-32.8-12.5-45.3 0zm-306.7 0c-12.5-12.5-32.8-12.5-45.3 0l-112 112c-12.5 12.5-12.5 32.8 0 45.3l112 112c12.5 12.5 32.8 12.5 45.3 0s12.5-32.8 0-45.3L77.3 256l89.4-89.4c12.5-12.5 12.5-32.8 0-45.3z","children":[]}]]],"height":"1em","width":"1em","xmlns":"http://www.w3.org/2000/svg"}] 1c:["$","svg",null,{"stroke":"currentColor","fill":"currentColor","strokeWidth":"0","viewBox":"0 0 448 512","color":"$undefined","className":"$undefined","style":{"color":"$undefined"},"aria-hidden":true,"children":["$undefined",[["$","path","0",{"d":"M80 104a24 24 0 1 0 0-48 24 24 0 1 0 0 48zm80-24c0 32.8-19.7 61-48 73.3l0 87.8c18.8-10.9 40.7-17.1 64-17.1l96 0c35.3 0 64-28.7 64-64l0-6.7C307.7 141 288 112.8 288 80c0-44.2 35.8-80 80-80s80 35.8 80 80c0 32.8-19.7 61-48 73.3l0 6.7c0 70.7-57.3 128-128 128l-96 0c-35.3 0-64 28.7-64 64l0 6.7c28.3 12.3 48 40.5 48 73.3c0 44.2-35.8 80-80 80s-80-35.8-80-80c0-32.8 19.7-61 48-73.3l0-6.7 0-198.7C19.7 141 0 112.8 0 80C0 35.8 35.8 0 80 0s80 35.8 80 80zm232 0a24 24 0 1 0 -48 0 24 24 0 1 0 48 0zM80 456a24 24 0 1 0 0-48 24 24 0 1 0 0 48z","children":[]}]]],"height":"1em","width":"1em","xmlns":"http://www.w3.org/2000/svg"}] 1d:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-green-500/10 text-green-600 dark:text-green-400","children":"GET"}] 1e:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 1f:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 20:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 21:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 22:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-green-500/10 text-green-600 dark:text-green-400","children":"GET"}] 23:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 24:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 25:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-green-500/10 text-green-600 dark:text-green-400","children":"GET"}] 26:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-green-500/10 text-green-600 dark:text-green-400","children":"GET"}] 27:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 28:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-green-500/10 text-green-600 dark:text-green-400","children":"GET"}] 29:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 2a:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 2b:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 2c:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 2d:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 2e:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-green-500/10 text-green-600 dark:text-green-400","children":"GET"}] 2f:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 30:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-green-500/10 text-green-600 dark:text-green-400","children":"GET"}] 31:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 32:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 33:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-green-500/10 text-green-600 dark:text-green-400","children":"GET"}] 34:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-green-500/10 text-green-600 dark:text-green-400","children":"GET"}] 35:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-orange-500/10 text-orange-600 dark:text-orange-400","children":"PATCH"}] 36:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-red-500/10 text-red-600 dark:text-red-400","children":"DEL"}] 37:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-green-500/10 text-green-600 dark:text-green-400","children":"GET"}] 38:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-green-500/10 text-green-600 dark:text-green-400","children":"GET"}] 39:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 3a:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-yellow-500/10 text-yellow-600 dark:text-yellow-400","children":"PUT"}] 3b:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-red-500/10 text-red-600 dark:text-red-400","children":"DEL"}] 3c:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 3d:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-orange-500/10 text-orange-600 dark:text-orange-400","children":"PATCH"}] 3e:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-red-500/10 text-red-600 dark:text-red-400","children":"DEL"}] 3f:["$","svg",null,{"stroke":"currentColor","fill":"currentColor","strokeWidth":"0","viewBox":"0 0 448 512","color":"$undefined","className":"$undefined","style":{"color":"$undefined"},"aria-hidden":true,"children":["$undefined",[["$","path","0",{"d":"M80 104a24 24 0 1 0 0-48 24 24 0 1 0 0 48zm80-24c0 32.8-19.7 61-48 73.3l0 87.8c18.8-10.9 40.7-17.1 64-17.1l96 0c35.3 0 64-28.7 64-64l0-6.7C307.7 141 288 112.8 288 80c0-44.2 35.8-80 80-80s80 35.8 80 80c0 32.8-19.7 61-48 73.3l0 6.7c0 70.7-57.3 128-128 128l-96 0c-35.3 0-64 28.7-64 64l0 6.7c28.3 12.3 48 40.5 48 73.3c0 44.2-35.8 80-80 80s-80-35.8-80-80c0-32.8 19.7-61 48-73.3l0-6.7 0-198.7C19.7 141 0 112.8 0 80C0 35.8 35.8 0 80 0s80 35.8 80 80zm232 0a24 24 0 1 0 -48 0 24 24 0 1 0 48 0zM80 456a24 24 0 1 0 0-48 24 24 0 1 0 0 48z","children":[]}]]],"height":"1em","width":"1em","xmlns":"http://www.w3.org/2000/svg"}] 40:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-green-500/10 text-green-600 dark:text-green-400","children":"GET"}] 41:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 42:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 43:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 44:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 45:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-green-500/10 text-green-600 dark:text-green-400","children":"GET"}] 46:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 47:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 48:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-green-500/10 text-green-600 dark:text-green-400","children":"GET"}] 49:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-green-500/10 text-green-600 dark:text-green-400","children":"GET"}] 4a:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 4b:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-green-500/10 text-green-600 dark:text-green-400","children":"GET"}] 4c:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 4d:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 4e:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 4f:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 50:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 51:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-green-500/10 text-green-600 dark:text-green-400","children":"GET"}] 52:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 53:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-green-500/10 text-green-600 dark:text-green-400","children":"GET"}] 54:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 55:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 56:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-green-500/10 text-green-600 dark:text-green-400","children":"GET"}] 57:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-green-500/10 text-green-600 dark:text-green-400","children":"GET"}] 58:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-orange-500/10 text-orange-600 dark:text-orange-400","children":"PATCH"}] 59:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-red-500/10 text-red-600 dark:text-red-400","children":"DEL"}] 5a:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-green-500/10 text-green-600 dark:text-green-400","children":"GET"}] 5b:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-green-500/10 text-green-600 dark:text-green-400","children":"GET"}] 5c:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 5d:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-yellow-500/10 text-yellow-600 dark:text-yellow-400","children":"PUT"}] 5e:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-red-500/10 text-red-600 dark:text-red-400","children":"DEL"}] 5f:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 60:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-orange-500/10 text-orange-600 dark:text-orange-400","children":"PATCH"}] 61:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-red-500/10 text-red-600 dark:text-red-400","children":"DEL"}] 62:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-blue-500/10 text-blue-600 dark:text-blue-400","children":"POST"}] 63:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-green-500/10 text-green-600 dark:text-green-400","children":"GET"}] 64:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-green-500/10 text-green-600 dark:text-green-400","children":"GET"}] 65:["$","span",null,{"className":"mt-0.5 w-11 shrink-0 self-start rounded-md py-0.5 text-center font-mono font-semibold text-[0.625rem] leading-4 bg-green-500/10 text-green-600 dark:text-green-400","children":"GET"}] 66:["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:0:icon"}] 67:["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1:icon"}] 68:["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$17"}] 69:["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$18"}] 6a:["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$19"}] 6b:["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$1a"}] 6c:["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$1b"}] 6d:["$","div","sidebar-banner",{"className":"flex flex-col gap-3","children":[["$","$L7d",null,{"options":[{"title":"Wallet SDK - Overview","description":"$undefined","url":"/wallets","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1:children:0","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1:children:0:icon"}],"props":"$undefined"},{"title":"Web","description":"Wallet SDK on Web","url":"/wallets/web/installation","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1:children:1","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$11"}],"props":"$undefined"},{"title":"Android","description":"Wallet SDK on Android","url":"/wallets/android/installation","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1:children:2","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$12"}],"props":"$undefined"},{"title":"iOS","description":"Wallet SDK on iOS","url":"/wallets/ios/installation","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1:children:3","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$13"}],"props":"$undefined"},{"title":"Flutter","description":"Wallet SDK on Flutter","url":"/wallets/flutter/installation","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1:children:4","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$14"}],"props":"$undefined"},{"title":"React Native","description":"Wallet SDK on React Native","url":"/wallets/react-native/installation","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1:children:5","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$15"}],"props":"$undefined"},{"title":".NET","description":"Wallet SDK on .NET","url":"/wallets/c-sharp/installation","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1:children:6","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$16"}],"props":"$undefined"},{"title":"2026-02-18 (Latest)","description":"$undefined","url":"/payments/api-reference","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:6:children:0","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$1c"}],"props":"$undefined"},{"title":"2026-02-19.preview","description":"$undefined","url":"/payments/api-reference/2026-02-19.preview/get-v1-gateway-payment-id","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:6:children:1","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$3f"}],"props":"$undefined"}],"className":"max-lg:hidden"}],["$","$L7e",null,{"anchors":["$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:4:anchors:0","$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:4:anchors:1","$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:4:anchors:2",{"anchor":"Report an Issue","href":"/report-an-issue","icon":"bug"}]}]]}] 6e:[["$","$L7f",null,{"src":"/logo/light.svg","alt":"WalletConnect","width":91,"height":24,"className":"h-6 w-auto dark:hidden","priority":true}],["$","$L7f",null,{"src":"/logo/dark.svg","alt":"WalletConnect","width":91,"height":24,"className":"hidden h-6 w-auto dark:block","priority":true}]] 6f:["$","$L84",null,{"data-home":true,"className":"pt-0 md:pt-0 xl:pt-0","full":true,"toc":[],"footer":{"enabled":false},"tableOfContent":{"enabled":false},"children":["$","$L85",null,{"className":"px-5","children":["$","div",null,{"className":"px-4 py-14 lg:px-10","children":[["$","div",null,{"className":"not-prose mb-8 flex flex-col items-center text-center","children":[["$","div",null,{"className":"not-prose text-2xl tracking-tight text-fd-foreground","children":"Page not found"}],["$","p",null,{"className":"mt-3 text-fd-muted-foreground","children":"The page you're looking for doesn't exist or has moved."}]]}],["$","div",null,{"className":"grid gap-4 sm:grid-cols-2","children":[["$","a",null,{"href":"/wallets","className":"group not-prose mb-5 block","children":["$","div",null,{"className":"flex flex-col rounded-xl md:p-1","children":[["$","div",null,{"className":"h-32 w-full overflow-hidden rounded-xl bg-fd-muted","children":[["$","img",null,{"src":"/images/wallet.svg","alt":"","loading":"lazy","className":"m-0 block h-full w-full object-cover object-center transition-transform duration-300 group-hover:scale-105 dark:hidden"}],["$","img",null,{"src":"/images/wallet-dark.svg","alt":"","loading":"lazy","className":"m-0 hidden h-full w-full object-cover object-center transition-transform duration-300 group-hover:scale-105 dark:block"}]]}],["$","div",null,{"className":"flex flex-col gap-1 pt-3 pb-2","children":[["$","h2",null,{"className":"text-2xl font-medium tracking-tight text-fd-foreground transition-colors group-hover:text-fd-muted-foreground","children":"Wallets"}],["$","p",null,{"className":"text-sm font-medium text-fd-muted-foreground","children":"Reach users on the network by joining our ecosystem of wallets."}],"$undefined"]}]]}]}],["$","a",null,{"href":"/apps","className":"group not-prose mb-5 block","children":["$","div",null,{"className":"flex flex-col rounded-xl md:p-1","children":[["$","div",null,{"className":"h-32 w-full overflow-hidden rounded-xl bg-fd-muted","children":[["$","img",null,{"src":"/images/app.svg","alt":"","loading":"lazy","className":"m-0 block h-full w-full object-cover object-center transition-transform duration-300 group-hover:scale-105 dark:hidden"}],["$","img",null,{"src":"/images/app-dark.svg","alt":"","loading":"lazy","className":"m-0 hidden h-full w-full object-cover object-center transition-transform duration-300 group-hover:scale-105 dark:block"}]]}],["$","div",null,{"className":"flex flex-col gap-1 pt-3 pb-2","children":[["$","h2",null,{"className":"text-2xl font-medium tracking-tight text-fd-foreground transition-colors group-hover:text-fd-muted-foreground","children":"Apps"}],["$","p",null,{"className":"text-sm font-medium text-fd-muted-foreground","children":"Provide wallet connections and user authentication for your app."}],"$undefined"]}]]}]}],["$","a",null,{"href":"/payments","className":"group not-prose mb-5 block","children":["$","div",null,{"className":"flex flex-col rounded-xl md:p-1","children":[["$","div",null,{"className":"h-32 w-full overflow-hidden rounded-xl bg-fd-muted","children":[["$","img",null,{"src":"/images/credit-card.svg","alt":"","loading":"lazy","className":"m-0 block h-full w-full object-cover object-center transition-transform duration-300 group-hover:scale-105 dark:hidden"}],["$","img",null,{"src":"/images/credit-card-dark.svg","alt":"","loading":"lazy","className":"m-0 hidden h-full w-full object-cover object-center transition-transform duration-300 group-hover:scale-105 dark:block"}]]}],["$","div",null,{"className":"flex flex-col gap-1 pt-3 pb-2","children":[["$","h2",null,{"className":"text-2xl font-medium tracking-tight text-fd-foreground transition-colors group-hover:text-fd-muted-foreground","children":"Payments"}],["$","p",null,{"className":"text-sm font-medium text-fd-muted-foreground","children":"Enable stablecoin and crypto payments as a wallet, app, PSP or merchant."}],"$undefined"]}]]}]}],["$","a",null,{"href":"/network","className":"group not-prose mb-5 block","children":["$","div",null,{"className":"flex flex-col rounded-xl md:p-1","children":[["$","div",null,{"className":"h-32 w-full overflow-hidden rounded-xl bg-fd-muted","children":["$L86","$L87"]}],"$L88"]}]}],"$L89","$L8a"]}]]}]}]}] 70:["$","$L8b",null,{"src":"/copy-agent-prompt.js","strategy":"lazyOnload"}] 72:["$","$1","c",{"children":[[["$","script","script-0",{"src":"/_next/static/chunks/28w04104cd2uz.js","async":true,"nonce":"$undefined"}],["$","script","script-1",{"src":"/_next/static/chunks/2k6hk9_iy7937.js","async":true,"nonce":"$undefined"}],["$","script","script-2",{"src":"/_next/static/chunks/3w-kfo01cns3i.js","async":true,"nonce":"$undefined"}]],["$","$L10",null,{"tree":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree","tabs":[{"title":"Home","description":"$undefined","url":"/","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:0","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:0:icon"}],"props":{"className":"hidden"}},{"title":"Wallets","description":"$undefined","url":"/wallets","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1:icon"}],"props":"$undefined"},{"title":"Wallet SDK - Overview","description":"$undefined","url":"/wallets","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1:children:0","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1:children:0:icon"}],"props":"$undefined"},{"title":"Web","description":"Wallet SDK on Web","url":"/wallets/web/installation","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1:children:1","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$11"}],"props":"$undefined"},{"title":"Android","description":"Wallet SDK on Android","url":"/wallets/android/installation","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1:children:2","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$12"}],"props":"$undefined"},{"title":"iOS","description":"Wallet SDK on iOS","url":"/wallets/ios/installation","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1:children:3","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$13"}],"props":"$undefined"},{"title":"Flutter","description":"Wallet SDK on Flutter","url":"/wallets/flutter/installation","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1:children:4","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$14"}],"props":"$undefined"},{"title":"React Native","description":"Wallet SDK on React Native","url":"/wallets/react-native/installation","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1:children:5","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$15"}],"props":"$undefined"},{"title":".NET","description":"Wallet SDK on .NET","url":"/wallets/c-sharp/installation","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1:children:6","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$16"}],"props":"$undefined"},{"title":"Apps","description":"$undefined","url":"/apps","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:2","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$17"}],"props":"$undefined"},{"title":"Network","description":"$undefined","url":"/network","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:3","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$18"}],"props":"$undefined"},{"title":"Payments","description":"$undefined","url":"/payments","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:4","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$19"}],"props":"$undefined"},{"title":"Wallet Verification","description":"$undefined","url":"/wallet-verification","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:5","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$1a"}],"props":"$undefined"},{"title":"API Reference","description":"$undefined","url":"/payments/api-reference","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:6","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$1b"}],"props":{"className":"lg:ms-auto"}},{"title":"2026-02-18 (Latest)","description":"$undefined","url":"/payments/api-reference","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:6:children:0","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$1c"}],"props":"$undefined"},{"title":"2026-02-19.preview","description":"$undefined","url":"/payments/api-reference/2026-02-19.preview/get-v1-gateway-payment-id","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:6:children:1","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$3f"}],"props":"$undefined"},{"title":"License Update","description":"$undefined","url":"/license-update","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:7","icon":"$undefined","props":{"className":"hidden"}},{"title":"FAQs","description":"$undefined","url":"/payments/merchant/faqs","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:8","icon":"$undefined","props":{"className":"hidden"}},{"title":"Report an Issue","description":"$undefined","url":"/payments/report-an-issue","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:9","icon":"$undefined","props":{"className":"hidden"}},{"title":"Flutter AI Prompt","description":"$undefined","url":"/payments/wallets/walletkit/ai-prompts/flutter","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:10","icon":"$undefined","props":{"className":"hidden"}},{"title":"Kotlin AI Prompt","description":"$undefined","url":"/payments/wallets/walletkit/ai-prompts/kotlin","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:11","icon":"$undefined","props":{"className":"hidden"}},{"title":"React Native AI Prompt","description":"$undefined","url":"/payments/wallets/walletkit/ai-prompts/react-native","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:12","icon":"$undefined","props":{"className":"hidden"}},{"title":"Swift AI Prompt","description":"$undefined","url":"/payments/wallets/walletkit/ai-prompts/swift","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:13","icon":"$undefined","props":{"className":"hidden"}},{"title":"Report an Issue","description":"$undefined","url":"/report-an-issue","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:14","icon":"$undefined","props":{"className":"hidden"}},{"title":"Security Information","description":"$undefined","url":"/security","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:15","icon":"$undefined","props":{"className":"hidden"}},{"title":"Extended WalletConnect Sessions Request for Apps","description":"$undefined","url":"/wallets/custodians/app-extended-sessions","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:16","icon":"$undefined","props":{"className":"hidden"}},{"title":"Chain Abstraction","description":"$undefined","url":"/wallets/features/chain-abstraction","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:17","icon":"$undefined","props":{"className":"hidden"}},{"title":"One-click Auth / SIWS","description":"$undefined","url":"/wallets/web/one-click-auth-siws","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:18","icon":"$undefined","props":{"className":"hidden"}}],"tabMode":"navbar","sidebar":{"banner":"$L8c","collapsible":false},"nav":{"title":"$L8d","url":"/","mode":"top"},"links":[{"text":"WalletGuide","url":"https://walletguide.walletconnect.network/","external":true},{"type":"button","text":"Request Demo","url":"https://share.hsforms.com/19Dpp4ayYR9uriB3xNAh0JAnxw6s","external":true,"on":"nav"}],"children":"$L8e"}]]}] 74:["$","$1","c",{"children":[null,["$","$Lb",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$Lc",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":"$undefined","forbidden":"$undefined","unauthorized":"$undefined"}]]}] 77:["$","$1","c",{"children":["$L8f",[["$","link","0",{"rel":"stylesheet","href":"/_next/static/chunks/2gs3drdnc84hp.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}],["$","script","script-0",{"src":"/_next/static/chunks/1igcq43sbjozt.js","async":true,"nonce":"$undefined"}],["$","script","script-1",{"src":"/_next/static/chunks/1n275h3wrj5e2.js","async":true,"nonce":"$undefined"}],["$","script","script-2",{"src":"/_next/static/chunks/2qp2xb8tppcgd.js","async":true,"nonce":"$undefined"}],["$","script","script-3",{"src":"/_next/static/chunks/1h8rnsmlzo_rf.js","async":true,"nonce":"$undefined"}]],["$","$L90",null,{"children":["$","$91",null,{"name":"Next.MetadataOutlet","children":"$@92"}]}]]}] 78:["$","$1","h",{"children":[null,["$","$L94",null,{"children":"$L95"}],["$","$L97",null,{"children":[["$","div",null,{"hidden":true,"children":["$","$91",null,{"name":"Next.Metadata","children":"$L98"}]}],null]}],["$","meta",null,{"name":"next-size-adjust","content":""}]]}] 7a:["$","link","0",{"rel":"stylesheet","href":"/_next/static/chunks/3-aug56xp2r0k.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}] 7b:["$","link","1",{"rel":"stylesheet","href":"/_next/static/chunks/1ofy9mtjm2soh.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}] 75:C 86:["$","img",null,{"src":"/images/network.svg","alt":"","loading":"lazy","className":"m-0 block h-full w-full object-cover object-center transition-transform duration-300 group-hover:scale-105 dark:hidden"}] 87:["$","img",null,{"src":"/images/network-dark.svg","alt":"","loading":"lazy","className":"m-0 hidden h-full w-full object-cover object-center transition-transform duration-300 group-hover:scale-105 dark:block"}] 88:["$","div",null,{"className":"flex flex-col gap-1 pt-3 pb-2","children":[["$","h2",null,{"className":"text-2xl font-medium tracking-tight text-fd-foreground transition-colors group-hover:text-fd-muted-foreground","children":"WalletConnect Network"}],["$","p",null,{"className":"text-sm font-medium text-fd-muted-foreground","children":"Discover the network powering 700+ wallets and 80,000+ apps."}],"$undefined"]}] 89:["$","a",null,{"href":"/wallet-verification","className":"group not-prose mb-5 block","children":["$","div",null,{"className":"flex flex-col rounded-xl md:p-1","children":[["$","div",null,{"className":"h-32 w-full overflow-hidden rounded-xl bg-fd-muted","children":[["$","img",null,{"src":"/images/wallet-verification.svg","alt":"","loading":"lazy","className":"m-0 block h-full w-full object-cover object-center transition-transform duration-300 group-hover:scale-105 dark:hidden"}],["$","img",null,{"src":"/images/wallet-verification-dark.svg","alt":"","loading":"lazy","className":"m-0 hidden h-full w-full object-cover object-center transition-transform duration-300 group-hover:scale-105 dark:block"}]]}],["$","div",null,{"className":"flex flex-col gap-1 pt-3 pb-2","children":[["$","h2",null,{"className":"text-2xl font-medium tracking-tight text-fd-foreground transition-colors group-hover:text-fd-muted-foreground","children":"Wallet Verification"}],["$","p",null,{"className":"text-sm font-medium text-fd-muted-foreground","children":"Prove that a user controls a crypto wallet by having them sign a message."}],"$undefined"]}]]}]}] 8a:["$","a",null,{"href":"/payments/api-reference","className":"group not-prose mb-5 block","children":["$","div",null,{"className":"flex flex-col rounded-xl md:p-1","children":[["$","div",null,{"className":"h-32 w-full overflow-hidden rounded-xl bg-fd-muted","children":[["$","img",null,{"src":"/images/api-reference.svg","alt":"","loading":"lazy","className":"m-0 block h-full w-full object-cover object-center transition-transform duration-300 group-hover:scale-105 dark:hidden"}],["$","img",null,{"src":"/images/api-reference-dark.svg","alt":"","loading":"lazy","className":"m-0 hidden h-full w-full object-cover object-center transition-transform duration-300 group-hover:scale-105 dark:block"}]]}],["$","div",null,{"className":"flex flex-col gap-1 pt-3 pb-2","children":[["$","h2",null,{"className":"text-2xl font-medium tracking-tight text-fd-foreground transition-colors group-hover:text-fd-muted-foreground","children":"API Reference"}],["$","p",null,{"className":"text-sm font-medium text-fd-muted-foreground","children":"Explore every WalletConnect Pay API endpoint, with authentication and versioning."}],"$undefined"]}]]}]}] 8c:["$","div","sidebar-banner",{"className":"flex flex-col gap-3","children":[["$","$L7d",null,{"options":["$72:props:children:1:props:tabs:2","$72:props:children:1:props:tabs:3","$72:props:children:1:props:tabs:4","$72:props:children:1:props:tabs:5","$72:props:children:1:props:tabs:6","$72:props:children:1:props:tabs:7","$72:props:children:1:props:tabs:8","$72:props:children:1:props:tabs:14","$72:props:children:1:props:tabs:15"],"className":"max-lg:hidden"}],["$","$L7e",null,{"anchors":"$6d:props:children:1:props:anchors"}]]}] 8d:[["$","$L7f",null,{"src":"/logo/light.svg","alt":"WalletConnect","width":91,"height":24,"className":"h-6 w-auto dark:hidden","priority":true}],["$","$L7f",null,{"src":"/logo/dark.svg","alt":"WalletConnect","width":91,"height":24,"className":"hidden h-6 w-auto dark:block","priority":true}]] 8e:["$","$Lb",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$Lc",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":[["$","$L10",null,{"tree":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree","tabs":[{"title":"Home","description":"$undefined","url":"/","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:0:icon"}],"props":{"className":"hidden"}},{"title":"Wallets","description":"$undefined","url":"/wallets","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1:icon"}],"props":"$undefined"},{"title":"Apps","description":"$undefined","url":"/apps","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$17"}],"props":"$undefined"},{"title":"Network","description":"$undefined","url":"/network","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$18"}],"props":"$undefined"},{"title":"Payments","description":"$undefined","url":"/payments","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$19"}],"props":"$undefined"},{"title":"Wallet Verification","description":"$undefined","url":"/wallet-verification","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$1a"}],"props":"$undefined"},{"title":"API Reference","description":"$undefined","url":"/payments/api-reference","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$1b"}],"props":{"className":"lg:ms-auto"}},{"title":"License Update","description":"$undefined","url":"/license-update","icon":"$undefined","props":{"className":"hidden"}},{"title":"FAQs","description":"$undefined","url":"/payments/merchant/faqs","icon":"$undefined","props":{"className":"hidden"}},{"title":"Report an Issue","description":"$undefined","url":"/payments/report-an-issue","icon":"$undefined","props":{"className":"hidden"}},{"title":"Flutter AI Prompt","description":"$undefined","url":"/payments/wallets/walletkit/ai-prompts/flutter","icon":"$undefined","props":{"className":"hidden"}},{"title":"Kotlin AI Prompt","description":"$undefined","url":"/payments/wallets/walletkit/ai-prompts/kotlin","icon":"$undefined","props":{"className":"hidden"}},{"title":"React Native AI Prompt","description":"$undefined","url":"/payments/wallets/walletkit/ai-prompts/react-native","icon":"$undefined","props":{"className":"hidden"}},{"title":"Swift AI Prompt","description":"$undefined","url":"/payments/wallets/walletkit/ai-prompts/swift","icon":"$undefined","props":{"className":"hidden"}},{"title":"Report an Issue","description":"$undefined","url":"/report-an-issue","icon":"$undefined","props":{"className":"hidden"}},{"title":"Security Information","description":"$undefined","url":"/security","icon":"$undefined","props":{"className":"hidden"}},{"title":"Extended WalletConnect Sessions Request for Apps","description":"$undefined","url":"/wallets/custodians/app-extended-sessions","icon":"$undefined","props":{"className":"hidden"}},{"title":"Chain Abstraction","description":"$undefined","url":"/wallets/features/chain-abstraction","icon":"$undefined","props":{"className":"hidden"}},{"title":"One-click Auth / SIWS","description":"$undefined","url":"/wallets/web/one-click-auth-siws","icon":"$undefined","props":{"className":"hidden"}}],"tabMode":"navbar","sidebar":{"banner":["$","div","sidebar-banner",{"className":"flex flex-col gap-3","children":[["$","$L7d",null,{"options":[{"title":"Wallet SDK - Overview","description":"$undefined","url":"/wallets","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1:children:0","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1:children:0:icon"}],"props":"$undefined"},{"title":"Web","description":"Wallet SDK on Web","url":"/wallets/web/installation","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1:children:1","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$11"}],"props":"$undefined"},{"title":"Android","description":"Wallet SDK on Android","url":"/wallets/android/installation","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1:children:2","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$12"}],"props":"$undefined"},{"title":"iOS","description":"Wallet SDK on iOS","url":"/wallets/ios/installation","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1:children:3","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$13"}],"props":"$undefined"},{"title":"Flutter","description":"Wallet SDK on Flutter","url":"/wallets/flutter/installation","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1:children:4","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$14"}],"props":"$undefined"},{"title":"React Native","description":"Wallet SDK on React Native","url":"/wallets/react-native/installation","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1:children:5","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$15"}],"props":"$undefined"},{"title":".NET","description":"Wallet SDK on .NET","url":"/wallets/c-sharp/installation","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:1:children:6","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$16"}],"props":"$undefined"},{"title":"2026-02-18 (Latest)","description":"$undefined","url":"/payments/api-reference","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:6:children:0","icon":["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$1c"}],"props":"$undefined"},{"title":"2026-02-19.preview","description":"$undefined","url":"/payments/api-reference/2026-02-19.preview/get-v1-gateway-payment-id","$folder":"$0:t:t:d:r:props:children:1:props:children:props:children:0:props:children:props:children:props:notFound:0:props:tree:children:6:children:1","icon":"$L99","props":"$undefined"}],"className":"max-lg:hidden"}],"$L9a"]}],"collapsible":false},"nav":{"title":"$L9b","url":"/","mode":"top"},"links":[{"text":"WalletGuide","url":"https://walletguide.walletconnect.network/","external":true},{"type":"button","text":"Request Demo","url":"https://share.hsforms.com/19Dpp4ayYR9uriB3xNAh0JAnxw6s","external":true,"on":"nav"}],"children":"$L9c"}],[]],"forbidden":"$undefined","unauthorized":"$undefined"}] 99:["$","div",null,{"className":"size-full [&_svg]:size-full","children":"$3f"}] 9a:["$","$L7e",null,{"anchors":"$6d:props:children:1:props:anchors"}] 9b:[["$","$L7f",null,{"src":"/logo/light.svg","alt":"WalletConnect","width":91,"height":24,"className":"h-6 w-auto dark:hidden","priority":true}],["$","$L7f",null,{"src":"/logo/dark.svg","alt":"WalletConnect","width":91,"height":24,"className":"hidden h-6 w-auto dark:block","priority":true}]] 9c:["$","$L84",null,{"data-home":true,"className":"pt-0 md:pt-0 xl:pt-0","full":true,"toc":[],"footer":{"enabled":false},"tableOfContent":{"enabled":false},"children":["$","$L85",null,{"className":"px-5","children":["$","div",null,{"className":"px-4 py-14 lg:px-10","children":[["$","div",null,{"className":"not-prose mb-8 flex flex-col items-center text-center","children":[["$","div",null,{"className":"not-prose text-2xl tracking-tight text-fd-foreground","children":"Page not found"}],["$","p",null,{"className":"mt-3 text-fd-muted-foreground","children":"The page you're looking for doesn't exist or has moved."}]]}],["$","div",null,{"className":"grid gap-4 sm:grid-cols-2","children":[["$","a",null,{"href":"/wallets","className":"group not-prose mb-5 block","children":["$","div",null,{"className":"flex flex-col rounded-xl md:p-1","children":[["$","div",null,{"className":"h-32 w-full overflow-hidden rounded-xl bg-fd-muted","children":[["$","img",null,{"src":"/images/wallet.svg","alt":"","loading":"lazy","className":"m-0 block h-full w-full object-cover object-center transition-transform duration-300 group-hover:scale-105 dark:hidden"}],["$","img",null,{"src":"/images/wallet-dark.svg","alt":"","loading":"lazy","className":"m-0 hidden h-full w-full object-cover object-center transition-transform duration-300 group-hover:scale-105 dark:block"}]]}],["$","div",null,{"className":"flex flex-col gap-1 pt-3 pb-2","children":[["$","h2",null,{"className":"text-2xl font-medium tracking-tight text-fd-foreground transition-colors group-hover:text-fd-muted-foreground","children":"Wallets"}],["$","p",null,{"className":"text-sm font-medium text-fd-muted-foreground","children":"Reach users on the network by joining our ecosystem of wallets."}],"$undefined"]}]]}]}],["$","a",null,{"href":"/apps","className":"group not-prose mb-5 block","children":["$","div",null,{"className":"flex flex-col rounded-xl md:p-1","children":[["$","div",null,{"className":"h-32 w-full overflow-hidden rounded-xl bg-fd-muted","children":[["$","img",null,{"src":"/images/app.svg","alt":"","loading":"lazy","className":"m-0 block h-full w-full object-cover object-center transition-transform duration-300 group-hover:scale-105 dark:hidden"}],["$","img",null,{"src":"/images/app-dark.svg","alt":"","loading":"lazy","className":"m-0 hidden h-full w-full object-cover object-center transition-transform duration-300 group-hover:scale-105 dark:block"}]]}],["$","div",null,{"className":"flex flex-col gap-1 pt-3 pb-2","children":[["$","h2",null,{"className":"text-2xl font-medium tracking-tight text-fd-foreground transition-colors group-hover:text-fd-muted-foreground","children":"Apps"}],["$","p",null,{"className":"text-sm font-medium text-fd-muted-foreground","children":"Provide wallet connections and user authentication for your app."}],"$undefined"]}]]}]}],["$","a",null,{"href":"/payments","className":"group not-prose mb-5 block","children":["$","div",null,{"className":"flex flex-col rounded-xl md:p-1","children":[["$","div",null,{"className":"h-32 w-full overflow-hidden rounded-xl bg-fd-muted","children":[["$","img",null,{"src":"/images/credit-card.svg","alt":"","loading":"lazy","className":"m-0 block h-full w-full object-cover object-center transition-transform duration-300 group-hover:scale-105 dark:hidden"}],["$","img",null,{"src":"/images/credit-card-dark.svg","alt":"","loading":"lazy","className":"m-0 hidden h-full w-full object-cover object-center transition-transform duration-300 group-hover:scale-105 dark:block"}]]}],["$","div",null,{"className":"flex flex-col gap-1 pt-3 pb-2","children":[["$","h2",null,{"className":"text-2xl font-medium tracking-tight text-fd-foreground transition-colors group-hover:text-fd-muted-foreground","children":"Payments"}],["$","p",null,{"className":"text-sm font-medium text-fd-muted-foreground","children":"Enable stablecoin and crypto payments as a wallet, app, PSP or merchant."}],"$undefined"]}]]}]}],["$","a",null,{"href":"/network","className":"group not-prose mb-5 block","children":["$","div",null,{"className":"flex flex-col rounded-xl md:p-1","children":[["$","div",null,{"className":"h-32 w-full overflow-hidden rounded-xl bg-fd-muted","children":["$L9d","$L9e"]}],"$L9f"]}]}],"$La0","$La1"]}]]}]}]}] 9d:["$","img",null,{"src":"/images/network.svg","alt":"","loading":"lazy","className":"m-0 block h-full w-full object-cover object-center transition-transform duration-300 group-hover:scale-105 dark:hidden"}] 9e:["$","img",null,{"src":"/images/network-dark.svg","alt":"","loading":"lazy","className":"m-0 hidden h-full w-full object-cover object-center transition-transform duration-300 group-hover:scale-105 dark:block"}] 9f:["$","div",null,{"className":"flex flex-col gap-1 pt-3 pb-2","children":[["$","h2",null,{"className":"text-2xl font-medium tracking-tight text-fd-foreground transition-colors group-hover:text-fd-muted-foreground","children":"WalletConnect Network"}],["$","p",null,{"className":"text-sm font-medium text-fd-muted-foreground","children":"Discover the network powering 700+ wallets and 80,000+ apps."}],"$undefined"]}] a0:["$","a",null,{"href":"/wallet-verification","className":"group not-prose mb-5 block","children":["$","div",null,{"className":"flex flex-col rounded-xl md:p-1","children":[["$","div",null,{"className":"h-32 w-full overflow-hidden rounded-xl bg-fd-muted","children":[["$","img",null,{"src":"/images/wallet-verification.svg","alt":"","loading":"lazy","className":"m-0 block h-full w-full object-cover object-center transition-transform duration-300 group-hover:scale-105 dark:hidden"}],["$","img",null,{"src":"/images/wallet-verification-dark.svg","alt":"","loading":"lazy","className":"m-0 hidden h-full w-full object-cover object-center transition-transform duration-300 group-hover:scale-105 dark:block"}]]}],["$","div",null,{"className":"flex flex-col gap-1 pt-3 pb-2","children":[["$","h2",null,{"className":"text-2xl font-medium tracking-tight text-fd-foreground transition-colors group-hover:text-fd-muted-foreground","children":"Wallet Verification"}],["$","p",null,{"className":"text-sm font-medium text-fd-muted-foreground","children":"Prove that a user controls a crypto wallet by having them sign a message."}],"$undefined"]}]]}]}] a1:["$","a",null,{"href":"/payments/api-reference","className":"group not-prose mb-5 block","children":["$","div",null,{"className":"flex flex-col rounded-xl md:p-1","children":[["$","div",null,{"className":"h-32 w-full overflow-hidden rounded-xl bg-fd-muted","children":[["$","img",null,{"src":"/images/api-reference.svg","alt":"","loading":"lazy","className":"m-0 block h-full w-full object-cover object-center transition-transform duration-300 group-hover:scale-105 dark:hidden"}],["$","img",null,{"src":"/images/api-reference-dark.svg","alt":"","loading":"lazy","className":"m-0 hidden h-full w-full object-cover object-center transition-transform duration-300 group-hover:scale-105 dark:block"}]]}],["$","div",null,{"className":"flex flex-col gap-1 pt-3 pb-2","children":[["$","h2",null,{"className":"text-2xl font-medium tracking-tight text-fd-foreground transition-colors group-hover:text-fd-muted-foreground","children":"API Reference"}],["$","p",null,{"className":"text-sm font-medium text-fd-muted-foreground","children":"Explore every WalletConnect Pay API endpoint, with authentication and versioning."}],"$undefined"]}]]}]}] 8f:["$","$L84",null,{"toc":[],"full":false,"children":[["$","div",null,{"className":"flex items-start justify-between gap-4","children":[["$","$La2",null,{"children":"Bybit Pay PSP order webhook"}],["$","$La4",null,{"markdownUrl":"/llms.mdx/payments/api-reference/2026-02-18/post-v1-webhooks-bybit-pay/content.md","aria-label":"Copy page","title":"Copy page","className":"mt-1 size-8 shrink-0 p-0","children":""}]]}],["$","$La5",null,{"children":"$undefined"}],["$","$L85",null,{"children":"$La6"}]]}] a6:["$","$La7",null,{"operations":[{"path":"/v1/webhooks/bybit_pay","method":"post"}],"document":"2026-02-18.json","preloaded":{"docs":{"2026-02-18.json":{"openapi":"3.2.0","info":{"title":"WalletConnect Pay API","version":"2026-02-18"},"servers":[{"url":"https://api.pay.walletconnect.com"}],"paths":{"/v1/gateway/payment/{id}":{"get":{"tags":["Gateway"],"summary":"Get a payment","description":"This endpoint returns only basic information to display to the user to begin the payment flow.","operationId":"gatewayGetPayment","parameters":[{"name":"Api-Key","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"App-Id","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Client-Id","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"WCP-Version","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Name","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Version","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Platform","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"id","in":"path","description":"Payment ID","required":true,"schema":{"$ref":"#/components/schemas/PaymentId"}}],"responses":{"200":{"description":"Payment status retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetPaymentResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Payment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"servers":[{"url":"https://api.pay.walletconnect.com"}],"security":[{"API Key":[]},{"ApiKey":[]},{"AppId":[]}]}},"/v1/gateway/payment/{id}/cancel":{"post":{"tags":["Gateway"],"operationId":"gatewayCancelPayment","parameters":[{"name":"Api-Key","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"App-Id","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Client-Id","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"WCP-Version","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Name","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Version","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Platform","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"id","in":"path","required":true,"schema":{"$ref":"#/components/schemas/PaymentId"}}],"responses":{"200":{"description":"Payment cancelled successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayCancelPaymentResponse"}}}},"400":{"description":"Payment cannot be cancelled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Payment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"servers":[{"url":"https://api.pay.walletconnect.com"}],"security":[{"API Key":[]},{"ApiKey":[]},{"AppId":[]}]}},"/v1/gateway/payment/{id}/confirm":{"post":{"tags":["Gateway"],"summary":"Confirm a payment","description":"This endpoint confirms a payment and submits it to the blockchain for processing.","operationId":"confirm_payment_handler","parameters":[{"name":"Api-Key","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"App-Id","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Client-Id","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"WCP-Version","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Name","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Version","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Platform","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"id","in":"path","description":"Payment ID","required":true,"schema":{"$ref":"#/components/schemas/PaymentId"}},{"name":"maxPollMs","in":"query","description":"Maximum time to long-poll for payment status, in milliseconds.","required":false,"schema":{"type":["integer","null"],"format":"int64","minimum":0}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmPaymentRequest"}}},"required":true},"responses":{"200":{"description":"Payment confirmed successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmPaymentResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Payment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"409":{"description":"Payment is no longer actionable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"servers":[{"url":"https://api.pay.walletconnect.com"}],"security":[{"API Key":[]},{"ApiKey":[]},{"AppId":[]}]}},"/v1/gateway/payment/{id}/fetch":{"post":{"tags":["Gateway"],"summary":"Fetches an action","operationId":"fetch_handler","parameters":[{"name":"Api-Key","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"App-Id","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Client-Id","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"WCP-Version","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Name","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Version","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Platform","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"id","in":"path","description":"Payment ID","required":true,"schema":{"$ref":"#/components/schemas/PaymentId"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FetchRequest"}}},"required":true},"responses":{"200":{"description":"Action built successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FetchResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Payment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"servers":[{"url":"https://api.pay.walletconnect.com"}],"security":[{"API Key":[]},{"ApiKey":[]},{"AppId":[]}]}},"/v1/gateway/payment/{id}/options":{"post":{"tags":["Gateway"],"summary":"Get payment options","description":"This endpoint takes a list of accounts and returns a list of options that can be used to complete the payment.","operationId":"gatewayGetPaymentOptions","parameters":[{"name":"Api-Key","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"App-Id","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Client-Id","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"WCP-Version","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Name","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Version","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Platform","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"id","in":"path","description":"Payment ID","required":true,"schema":{"$ref":"#/components/schemas/PaymentId"}},{"name":"includePaymentInfo","in":"query","description":"Whether to include payment information in the response","required":false,"schema":{"type":["boolean","null"]}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetPaymentOptionsRequest"}}},"required":true},"responses":{"200":{"description":"Payment options retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetPaymentOptionsResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Payment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"servers":[{"url":"https://api.pay.walletconnect.com"}],"security":[{"API Key":[]},{"ApiKey":[]},{"AppId":[]}]}},"/v1/gateway/payment/{id}/status":{"get":{"tags":["Gateway"],"summary":"Get the payment status","description":"Retrieves the status of a payment by its ID. Returns a polling delay to wait\nbefore checking the status again.","operationId":"gatewayGetPaymentStatus","parameters":[{"name":"Api-Key","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"App-Id","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Client-Id","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"WCP-Version","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Name","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Version","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Platform","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"id","in":"path","description":"Payment ID","required":true,"schema":{"$ref":"#/components/schemas/PaymentId"}},{"name":"maxPollMs","in":"query","description":"Maximum time to long-poll for payment status, in milliseconds.","required":false,"schema":{"type":["integer","null"],"format":"int64","minimum":0}}],"responses":{"200":{"description":"Payment status retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetPaymentStatusResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Payment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"servers":[{"url":"https://api.pay.walletconnect.com"}],"security":[{"API Key":[]},{"ApiKey":[]},{"AppId":[]}]}},"/v1/gateway/payment/{id}/transition":{"post":{"tags":["Gateway"],"operationId":"gatewayTransition","parameters":[{"name":"Api-Key","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"App-Id","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Client-Id","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"WCP-Version","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Name","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Version","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Platform","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"id","in":"path","description":"Payment ID","required":true,"schema":{"$ref":"#/components/schemas/PaymentId"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTransitionRequest"}}},"required":true},"responses":{"200":{"description":"Payment transitioned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestTransitionResponse"}}}},"400":{"description":"Non-test payment or invalid transition","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Payment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"servers":[{"url":"https://api.pay.walletconnect.com"}],"security":[{"API Key":[]},{"ApiKey":[]},{"AppId":[]}]}},"/v1/payments":{"post":{"tags":["Payments"],"summary":"Create a new payment","description":"Creates a new payment with the provided payment details.","operationId":"paymentsCreatePayment","parameters":[{"name":"Api-Key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Merchant-Id","in":"header","required":true,"schema":{"type":"string"}},{"name":"WCP-Version","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Name","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Version","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Platform","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":["string","null"]}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePayment"}}},"required":true},"responses":{"201":{"description":"Payment created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePaymentResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"servers":[{"url":"https://api.pay.walletconnect.com"}],"security":[{"API Key":[]},{"ApiKey":[]},{"AppId":[]}]},"get":{"operationId":"PartnerPayments_list","parameters":[{"name":"WCP-Version","in":"header","required":false,"description":"Optional WalletConnect Pay API version override. If omitted, the partner's pinned version is used.","schema":{"type":"string","examples":["2026-02-18","2026-02-19.preview"]}},{"in":"query","name":"startTs","schema":{"examples":["2026-01-06T00:00:00Z"],"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"description":"RFC3339 timestamp, inclusive"},{"in":"query","name":"endTs","schema":{"examples":["2026-01-07T00:00:00Z"],"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"description":"RFC3339 timestamp, exclusive"},{"in":"query","name":"token_symbol","schema":{"type":"array","items":{"type":"string","minLength":1}},"description":"Filter by token symbol (e.g. `USDC`). CAIP-19 identifiers are not supported. Accepts a single value or multiple repeated params:\n\n- Single: `?token_symbol=USDC`\n- Multiple: `?token_symbol=USDC&token_symbol=EURC`"},{"in":"query","name":"network","schema":{"examples":["eip155:8453","eip155:8453,eip155:1"],"type":"string"},"description":"Filter by [CAIP-2](https://standards.chainagnostic.org/CAIPs/caip-2) chain ID. Comma-separated for multiple."},{"in":"query","name":"sortBy","schema":{"type":"string","enum":["date","amount"]},"description":"Field to sort by"},{"in":"query","name":"sortDir","schema":{"type":"string","enum":["asc","desc"]},"description":"Sort direction"},{"in":"query","name":"cursor","schema":{"type":"string"},"description":"Opaque pagination cursor — use the value from `nextCursor` in the previous response."},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":200},"description":"Page size (default 50, max 200)"},{"in":"query","name":"status","schema":{"type":"array","items":{"type":"string","enum":["requires_action","processing","succeeded","failed","expired"]}},"description":"Filter by payment status. Accepts a single value or multiple repeated params:\n\n- Single: `?status=succeeded`\n- Multiple: `?status=succeeded&status=processing`"},{"in":"query","name":"referenceId","schema":{"type":"string","minLength":3,"maxLength":35,"pattern":"^[A-Za-z0-9 /:.,+-]+$","examples":["order-42"]},"description":"Substring search on the merchant-provided reference ID. Between 3 and 35 characters. Allowed characters: ASCII letters, digits, and ` /-:.,+`."},{"in":"query","name":"merchantId","schema":{"type":"array","items":{"type":"string","minLength":1},"examples":[["acme-store-1"],["acme-store-1","widget_co"]]},"description":"Filter by merchant ID. Accepts a single value or multiple repeated params:\n\n- Single: `?merchantId=acme-store-1`\n- Multiple: `?merchantId=acme-store-1&merchantId=widget_co`"}],"responses":{"200":{"description":"Payments with statistics","headers":{"WCP-Version":{"description":"WalletConnect Pay API version resolved for this request.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MerchantPaymentsResponse"},"example":{"data":[{"paymentId":"pay_a1a2ecc101KGF210FP7PN3BK08PZARS1CZ","merchant":{"id":"acme-store-1","name":"Acme Store","iconUrl":"https://imagedelivery.net/example/icon.png"},"referenceId":"a1b2cad4e5f2783012345678axcdea90","status":"succeeded","isTerminal":true,"paymentUrl":"https://pay.walletconnect.com/?pid=pay_a1a2ecc101KGF210FP7PN3BK08PZARS1CZ","fiatAmount":{"unit":"iso4217/USD","value":"500","display":{"assetSymbol":"USD","assetName":"US Dollar","decimals":2}},"tokenAmount":{"unit":"caip19/eip155:8453/erc20:0x0000000000000000000000000000000000000000","value":"5000000","display":{"assetSymbol":"USDC","assetName":"USD Coin","decimals":6,"networkName":"Base","iconUrl":"https://api.walletconnect.com/assets/v1/image/token/USDC/md","networkIconUrl":"https://api.walletconnect.com/assets/v1/image/network/eip155%3A8453/md"}},"buyer":{"accountCaip10":"eip155:8453:0x0000000000000000000000000000000000000000","accountProviderName":"MetaMask","accountProviderIcon":"https://api.walletconnect.com/assets/v1/image/wallet/metamask/md"},"transaction":{"networkId":"8453","hash":"0x0000000000000000000000000000000000000000000000000000000000000000"},"settlement":{"amount":{"unit":"caip19/eip155:8453/erc20:0x0000000000000000000000000000000000000000","value":"4840000","display":{"assetSymbol":"USDC","assetName":"USD Coin","decimals":6,"iconUrl":"https://api.walletconnect.com/assets/v1/image/token/USDC/md","networkName":"Base","networkIconUrl":"https://api.walletconnect.com/assets/v1/image/network/eip155%3A8453/md"}},"settled":true,"txHash":"0x0000000000000000000000000000000000000000000000000000000000000000"},"fees":{"total":{"unit":"caip19/eip155:8453/erc20:0x0000000000000000000000000000000000000000","value":"160000","display":{"assetSymbol":"USDC","assetName":"USD Coin","decimals":6,"iconUrl":"https://api.walletconnect.com/assets/v1/image/token/USDC/md","networkName":"Base","networkIconUrl":"https://api.walletconnect.com/assets/v1/image/network/eip155%3A8453/md"}},"fixed":{"unit":"caip19/eip155:8453/erc20:0x0000000000000000000000000000000000000000","value":"140000","display":{"assetSymbol":"USDC","assetName":"USD Coin","decimals":6,"iconUrl":"https://api.walletconnect.com/assets/v1/image/token/USDC/md","networkName":"Base","networkIconUrl":"https://api.walletconnect.com/assets/v1/image/network/eip155%3A8453/md"}},"percentage":"0.4"},"refund":{"status":"fully_refunded","fullyRefundedAt":"2024-01-02T08:30:00.000Z"},"createdAt":"2024-01-01T12:00:00.000Z","expiresAt":"2024-01-01T12:15:00.000Z","lastUpdatedAt":"2024-01-01T12:00:00.000Z","settledAt":"2024-01-01T12:00:00.000Z"}],"nextCursor":null,"stats":{"totalRevenue":[{"amount":1000,"currency":"USD"}],"totalTransactions":100,"totalCustomers":25}}}}},"400":{"description":"Bad request — invalid parameters or API version","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["invalid_params","params_validation","invalid_api_version","unknown_api_version","api_version_downgrade"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"issues":{"description":"Field-level validation issues (present on validation errors)","type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"]}}},"required":["message","code"]},"examples":{"invalid_params":{"summary":"Invalid request parameters","value":{"code":"invalid_params","message":"Invalid request parameters"}},"params_validation":{"summary":"Validation failed","value":{"code":"params_validation","message":"Validation failed"}},"invalid_api_version":{"summary":"Invalid API version","value":{"code":"invalid_api_version","message":"Invalid API version"}},"unknown_api_version":{"summary":"Unknown API version","value":{"code":"unknown_api_version","message":"Unknown API version"}},"api_version_downgrade":{"summary":"Requested API version is older than the partner pin","value":{"code":"api_version_downgrade","message":"Requested API version is older than the partner pin"}}}}}},"401":{"description":"Unauthorized — missing or invalid partner API key","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"code":"missing_api_key","message":"Missing API key"}},"invalid_api_key":{"summary":"Invalid API key","value":{"code":"invalid_api_key","message":"Invalid API key"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"internal_error","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"internal_error":{"summary":"Internal Server Error","value":{"code":"internal_error","message":"Internal Server Error"}}}}}}},"tags":["Payments"],"summary":"List payments","description":"Retrieve paginated payments with optional filters.","servers":[{"url":"https://api.merchant.pay.walletconnect.com"}],"security":[{"apiKey":[]}]}},"/v1/payments/{id}":{"get":{"tags":["Payments"],"summary":"Get payment details","description":"Retrieves the full details of a payment by its ID, including settlement\ninformation when available.","operationId":"paymentsGetPayment","parameters":[{"name":"Api-Key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Merchant-Id","in":"header","required":true,"schema":{"type":"string"}},{"name":"WCP-Version","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Name","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Version","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Platform","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"id","in":"path","description":"Payment ID","required":true,"schema":{"$ref":"#/components/schemas/PaymentId"}}],"responses":{"200":{"description":"Payment details retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentsGetPaymentResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Payment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"servers":[{"url":"https://api.pay.walletconnect.com"}],"security":[{"API Key":[]},{"ApiKey":[]},{"AppId":[]}]}},"/v1/payments/{id}/cancel":{"post":{"tags":["Payments"],"operationId":"paymentsCancelPayment","parameters":[{"name":"Api-Key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Merchant-Id","in":"header","required":true,"schema":{"type":"string"}},{"name":"WCP-Version","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Name","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Version","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Platform","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"id","in":"path","required":true,"schema":{"$ref":"#/components/schemas/PaymentId"}}],"responses":{"200":{"description":"Payment cancelled successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentsCancelPaymentResponse"}}}},"400":{"description":"Payment cannot be cancelled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Payment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"servers":[{"url":"https://api.pay.walletconnect.com"}],"security":[{"API Key":[]},{"ApiKey":[]},{"AppId":[]}]}},"/v1/payments/{id}/status":{"get":{"tags":["Payments"],"summary":"Get the payment status","description":"Retrieves the status of a payment by its ID. Returns a polling delay to wait\nbefore checking the status again.","operationId":"paymentsGetPaymentStatus","parameters":[{"name":"Api-Key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Merchant-Id","in":"header","required":true,"schema":{"type":"string"}},{"name":"WCP-Version","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Name","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Version","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Platform","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"id","in":"path","description":"Payment ID","required":true,"schema":{"$ref":"#/components/schemas/PaymentId"}},{"name":"maxPollMs","in":"query","description":"Maximum time to long-poll for payment status, in milliseconds.","required":false,"schema":{"type":["integer","null"],"format":"int64","minimum":0}}],"responses":{"200":{"description":"Payment status retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetPaymentStatusResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Payment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"servers":[{"url":"https://api.pay.walletconnect.com"}],"security":[{"API Key":[]},{"ApiKey":[]},{"AppId":[]}]}},"/v1/payments/{id}/transition":{"post":{"tags":["Payments"],"operationId":"paymentsTransition","parameters":[{"name":"Api-Key","in":"header","required":true,"schema":{"type":"string"}},{"name":"Merchant-Id","in":"header","required":true,"schema":{"type":"string"}},{"name":"WCP-Version","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Name","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Version","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Sdk-Platform","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":["string","null"]}},{"name":"id","in":"path","description":"Payment ID","required":true,"schema":{"$ref":"#/components/schemas/PaymentId"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestTransitionRequest"}}},"required":true},"responses":{"200":{"description":"Payment transitioned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestTransitionResponse"}}}},"400":{"description":"Non-test payment or invalid transition","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Payment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"servers":[{"url":"https://api.pay.walletconnect.com"}],"security":[{"API Key":[]},{"ApiKey":[]},{"AppId":[]}]}},"/v1/webhooks/binance_pay":{"post":{"tags":["Webhooks"],"summary":"Binance Pay webhook (single callback)","description":"The single `merchant_callback_url` Binance calls for all events. RSA-signature-verified (no API key); dispatches on `bizType` — `TECH_PROVIDER` (authorisation) or `PAY` (order lifecycle). Unknown types are acknowledged so Binance stops retrying, but the event is dropped and alerted on as unhandled.","operationId":"binancePayWebhook","requestBody":{"content":{"text/plain":{"schema":{"type":"string"}}},"required":true},"responses":{"200":{"description":"Acknowledged"},"400":{"description":"Malformed payload or missing headers"},"401":{"description":"Signature verification failed"},"404":{"description":"Unknown authorisation request / order"},"500":{"description":"Internal error (Binance retries)"}},"servers":[{"url":"https://api.pay.walletconnect.com"}],"security":[{"API Key":[]},{"ApiKey":[]},{"AppId":[]}]}},"/v1/webhooks/binance_pay_onchain":{"post":{"tags":["Webhooks"],"summary":"Binance Pay Onchain order-status webhook","description":"Order-status-change events for Binance Pay Onchain orders. SHA256withRSA-signature-verified against Binance's static partner public key (no API key); `X-BN-Connect-For` must name our partner code. Terminal-failure statuses fail the payment; success statuses record the reported withdrawal facts (the payment succeeds only after on-chain receipt verification).","operationId":"binancePayOnchainWebhook","requestBody":{"content":{"text/plain":{"schema":{"type":"string"}}},"required":true},"responses":{"200":{"description":"Acknowledged (including event types and payloads this build cannot use)"},"400":{"description":"Missing headers"},"401":{"description":"Signature verification failed"},"403":{"description":"Webhook addressed to another partner"},"500":{"description":"Verification key/client unavailable or transient failure (Binance redelivers)"},"503":{"description":"Webhook verification is not configured (Binance redelivers)"}},"servers":[{"url":"https://api.pay.walletconnect.com"}],"security":[{"API Key":[]},{"ApiKey":[]},{"AppId":[]}]}},"/v1/webhooks/bybit_pay":{"post":{"tags":["Webhooks"],"summary":"Bybit Pay PSP order webhook","description":"Order-status events for Bybit Pay PSP orders. Authenticated by the RSA-SHA256 signature over `timestamp + rawRequestBody` (headers `timestamp`, `signature`), verified against the public key pinned in configuration — there is no API key, and the in-request `publicKey` header is not trusted. A pay-order event is a trigger only: the order is re-queried from Bybit under our own credentials and the payment is driven from that answer (paid → succeeded; expired → the order is closed and the payment stays payable by another method). Every deterministic outcome is acknowledged with HTTP 200 and the plain-text body `success`.","operationId":"bybitPayWebhook","requestBody":{"content":{"text/plain":{"schema":{"type":"string"}}},"required":true},"responses":{"200":{"description":"Acknowledged — plain-text body `success` (including payloads this build cannot use)"},"400":{"description":"Missing `timestamp` or `signature` header"},"401":{"description":"Signature verification failed, or the timestamp is outside the accepted window"},"500":{"description":"Storage failure, write contention, or an internal invariant violation (Bybit redelivers)"},"502":{"description":"The order re-query to Bybit failed (Bybit redelivers)"},"503":{"description":"Webhook verification or the Bybit client is not configured, or the configured key is unusable (Bybit redelivers)"}},"servers":[{"url":"https://api.pay.walletconnect.com"}],"security":[{"API Key":[]},{"ApiKey":[]},{"AppId":[]}]}},"/v1/refunds":{"post":{"operationId":"Refunds_create","parameters":[{"name":"Merchant-Id","in":"header","required":true,"description":"Merchant identifier.","schema":{"type":"string","examples":["acme-store-1"]}},{"name":"WCP-Version","in":"header","required":false,"description":"Optional WalletConnect Pay API version override. If omitted, the partner's pinned version is used.","schema":{"type":"string","examples":["2026-02-18","2026-02-19.preview"]}}],"responses":{"200":{"description":"Payment marked as refunded","headers":{"WCP-Version":{"description":"WalletConnect Pay API version resolved for this request.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"paymentId":{"type":"string","description":"Payment ID that was marked as refunded"}},"required":["paymentId"]},"example":{"paymentId":"pay_a1a2ecc101KGF210FP7PN3BK08PZARS1CZ"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["params_validation","payment_not_succeeded","invalid_api_version","unknown_api_version","api_version_downgrade"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"issues":{"description":"Field-level validation issues (present on validation errors)","type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"]}}},"required":["message","code"]},"examples":{"params_validation":{"summary":"Validation failed","value":{"code":"params_validation","message":"Validation failed"}},"payment_not_succeeded":{"summary":"Payment is not in a refundable state","value":{"code":"payment_not_succeeded","message":"Payment is not in a refundable state"}},"invalid_api_version":{"summary":"Invalid API version","value":{"code":"invalid_api_version","message":"Invalid API version"}},"unknown_api_version":{"summary":"Unknown API version","value":{"code":"unknown_api_version","message":"Unknown API version"}},"api_version_downgrade":{"summary":"Requested API version is older than the partner pin","value":{"code":"api_version_downgrade","message":"Requested API version is older than the partner pin"}}}}}},"401":{"description":"Unauthorized — missing or invalid API key, or missing merchant id","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["missing_api_key","invalid_api_key","missing_merchant_id"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"code":"missing_api_key","message":"Missing API key"}},"invalid_api_key":{"summary":"Invalid API key","value":{"code":"invalid_api_key","message":"Invalid API key"}},"missing_merchant_id":{"summary":"Missing Merchant ID","value":{"code":"missing_merchant_id","message":"Missing Merchant ID"}}}}}},"404":{"description":"Payment not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"not_found","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"not_found":{"summary":"Not Found","value":{"code":"not_found","message":"Not Found"}}}}}},"409":{"description":"Payment is already refunded","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"already_refunded","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"already_refunded":{"summary":"Payment is already refunded","value":{"code":"already_refunded","message":"Payment is already refunded"}}}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"internal_error","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"internal_error":{"summary":"Internal Server Error","value":{"code":"internal_error","message":"Internal Server Error"}}}}}},"502":{"description":"Bad gateway","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"bad_gateway","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"bad_gateway":{"summary":"Bad Gateway","value":{"code":"bad_gateway","message":"Bad Gateway"}}}}}}},"tags":["Refunds"],"summary":"Mark a payment as refunded","description":"Request a full refund for a payment. Calling a second time on the same payment returns 409.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"paymentId":{"type":"string","minLength":1,"maxLength":64,"pattern":"^pay_[A-Za-z0-9]+$","description":"Payment ID to refund","examples":["pay_a1a2ecc101KGF210FP7PN3BK08PZARS1CZ"]}},"required":["paymentId"]}}}},"servers":[{"url":"https://api.merchant.pay.walletconnect.com"}],"security":[{"apiKey":[]}]}},"/v1/sign/{token}/required-signings":{"get":{"operationId":"Sign_listRequired","tags":["Sign"],"summary":"List documents the merchant still needs to sign","description":"Token-gated: returns the documents Iron requires the merchant to sign. The token is issued in the partner-API `kybUrl` once the case enters the signing stage. Every failure mode — unknown token, expired token, wrong case state, wrong provider — collapses to `404 not_found` so the endpoint does not leak case state to unauthenticated callers. Rate-limited to 60 requests per minute per source IP.","responses":{"200":{"description":"Documents the merchant still needs to sign.","content":{"application/json":{"schema":{"type":"object","properties":{"signings":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Opaque signing identifier. Pass back unchanged in `POST /sign/:token/signings`.","examples":["sig_01HXYZK3J7QV2P4N8R9M5T6W7B"]},"displayName":{"type":"string","description":"Human-readable name of the document to be signed (e.g. terms of service, beneficial owner attestation).","examples":["Beneficial Owner Attestation"]},"url":{"type":"string","description":"Hosted signing URL the merchant should open to review and sign the document.","examples":["https://signings.iron.io/s/01HXYZK3J7QV2P4N8R9M5T6W7B"]}},"required":["id","displayName","url"]},"description":"Documents the merchant still needs to sign. Empty when no signatures are outstanding."}},"required":["signings"]},"example":{"signings":[{"id":"sig_01HXYZK3J7QV2P4N8R9M5T6W7B","displayName":"Beneficial Owner Attestation","url":"https://signings.iron.io/s/01HXYZK3J7QV2P4N8R9M5T6W7B"}]}}}},"404":{"description":"Token invalid or case is not awaiting signatures","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"not_found","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"not_found":{"summary":"Not Found","value":{"code":"not_found","message":"Not Found"}}}}}},"502":{"description":"Provider API error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"bad_gateway","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"bad_gateway":{"summary":"Bad Gateway","value":{"code":"bad_gateway","message":"Bad Gateway"}}}}}}},"parameters":[{"in":"path","name":"token","schema":{"type":"string","minLength":1,"examples":["sig_tkn_8f4a3b6e2c1d4f5a9b8c7d6e5f4a3b2c"]},"required":true,"description":"Token-gated path parameter issued in the partner-API `kybUrl` when the case enters the signing stage. Invalidated once the case advances out of the signing stage."}],"servers":[{"url":"https://api.merchant.pay.walletconnect.com"}],"security":[{"apiKey":[]}]}},"/v1/sign/{token}/signings":{"post":{"operationId":"Sign_submit","tags":["Sign"],"summary":"Submit signed documents","description":"Token-gated: marks the listed documents as signed. Returns `200` with `allSigned: true` when every required signing has been completed and the case has advanced out of the signing stage — the token is then invalidated. Returns `202` with `allSigned: false` when more signatures are still required and the merchant should keep signing. Like the GET endpoint, every authorization failure collapses to `404 not_found`. Rate-limited to 60 requests per minute per source IP.","responses":{"200":{"description":"All required documents signed. The case has advanced and the token is invalidated.","content":{"application/json":{"schema":{"type":"object","properties":{"allSigned":{"type":"boolean","description":"`true` when every required signing has been completed and the case has advanced out of the signing stage (200). `false` when more signatures are still required (202).","examples":[true]}},"required":["allSigned"]},"example":{"allSigned":true}}}},"202":{"description":"Signings accepted; more documents remain to be signed.","content":{"application/json":{"schema":{"type":"object","properties":{"allSigned":{"type":"boolean","description":"`true` when every required signing has been completed and the case has advanced out of the signing stage (200). `false` when more signatures are still required (202).","examples":[true]}},"required":["allSigned"]},"example":{"allSigned":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["params_validation","invalid_params"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"issues":{"description":"Field-level validation issues (present on validation errors)","type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"]}}},"required":["message","code"]},"examples":{"params_validation":{"summary":"Validation failed","value":{"code":"params_validation","message":"Validation failed"}},"invalid_params":{"summary":"Invalid request parameters","value":{"code":"invalid_params","message":"Invalid request parameters"}}}}}},"404":{"description":"Token invalid or case is not awaiting signatures","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"not_found","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"not_found":{"summary":"Not Found","value":{"code":"not_found","message":"Not Found"}}}}}},"502":{"description":"Provider API error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"bad_gateway","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"bad_gateway":{"summary":"Bad Gateway","value":{"code":"bad_gateway","message":"Bad Gateway"}}}}}}},"parameters":[{"in":"path","name":"token","schema":{"type":"string","minLength":1,"examples":["sig_tkn_8f4a3b6e2c1d4f5a9b8c7d6e5f4a3b2c"]},"required":true,"description":"Token-gated path parameter issued in the partner-API `kybUrl` when the case enters the signing stage. Invalidated once the case advances out of the signing stage."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"signingIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"IDs of the signings the merchant has just completed. Must be a non-empty subset of the IDs returned by `GET /sign/:token/required-signings`.","examples":[["sig_01HXYZK3J7QV2P4N8R9M5T6W7B"]]}},"required":["signingIds"],"examples":[{"signingIds":["sig_01HXYZK3J7QV2P4N8R9M5T6W7B"]}]}}}},"servers":[{"url":"https://api.merchant.pay.walletconnect.com"}],"security":[{"apiKey":[]}]}},"/v1/merchants/payments":{"get":{"operationId":"MerchantPayments_list","parameters":[{"name":"Merchant-Id","in":"header","required":true,"description":"Merchant identifier.","schema":{"type":"string","examples":["acme-store-1"]}},{"name":"WCP-Version","in":"header","required":false,"description":"Optional WalletConnect Pay API version override. If omitted, the partner's pinned version is used.","schema":{"type":"string","examples":["2026-02-18","2026-02-19.preview"]}},{"in":"query","name":"startTs","schema":{"examples":["2026-01-06T00:00:00Z"],"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"description":"RFC3339 timestamp, inclusive"},{"in":"query","name":"endTs","schema":{"examples":["2026-01-07T00:00:00Z"],"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"description":"RFC3339 timestamp, exclusive"},{"in":"query","name":"token_symbol","schema":{"type":"array","items":{"type":"string","minLength":1}},"description":"Filter by token symbol (e.g. `USDC`). CAIP-19 identifiers are not supported. Accepts a single value or multiple repeated params:\n\n- Single: `?token_symbol=USDC`\n- Multiple: `?token_symbol=USDC&token_symbol=EURC`"},{"in":"query","name":"network","schema":{"examples":["eip155:8453","eip155:8453,eip155:1"],"type":"string"},"description":"Filter by [CAIP-2](https://standards.chainagnostic.org/CAIPs/caip-2) chain ID. Comma-separated for multiple."},{"in":"query","name":"sortBy","schema":{"type":"string","enum":["date","amount"]},"description":"Field to sort by"},{"in":"query","name":"sortDir","schema":{"type":"string","enum":["asc","desc"]},"description":"Sort direction"},{"in":"query","name":"cursor","schema":{"type":"string"},"description":"Opaque pagination cursor — use the value from `nextCursor` in the previous response."},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":200},"description":"Page size (default 50, max 200)"},{"in":"query","name":"status","schema":{"type":"array","items":{"type":"string","enum":["requires_action","processing","succeeded","failed","expired"]}},"description":"Filter by payment status. Accepts a single value or multiple repeated params:\n\n- Single: `?status=succeeded`\n- Multiple: `?status=succeeded&status=processing`"},{"in":"query","name":"referenceId","schema":{"type":"string","minLength":3,"maxLength":35,"pattern":"^[A-Za-z0-9 /:.,+-]+$","examples":["order-42"]},"description":"Substring search on the merchant-provided reference ID. Between 3 and 35 characters. Allowed characters: ASCII letters, digits, and ` /-:.,+`."}],"responses":{"200":{"description":"Payments with statistics","headers":{"WCP-Version":{"description":"WalletConnect Pay API version resolved for this request.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MerchantPaymentsResponse"},"example":{"data":[{"paymentId":"pay_a1a2ecc101KGF210FP7PN3BK08PZARS1CZ","merchant":{"id":"acme-store-1","name":"Acme Store","iconUrl":"https://imagedelivery.net/example/icon.png"},"referenceId":"a1b2cad4e5f2783012345678axcdea90","status":"succeeded","isTerminal":true,"paymentUrl":"https://pay.walletconnect.com/?pid=pay_a1a2ecc101KGF210FP7PN3BK08PZARS1CZ","fiatAmount":{"unit":"iso4217/USD","value":"500","display":{"assetSymbol":"USD","assetName":"US Dollar","decimals":2}},"tokenAmount":{"unit":"caip19/eip155:8453/erc20:0x0000000000000000000000000000000000000000","value":"5000000","display":{"assetSymbol":"USDC","assetName":"USD Coin","decimals":6,"networkName":"Base","iconUrl":"https://api.walletconnect.com/assets/v1/image/token/USDC/md","networkIconUrl":"https://api.walletconnect.com/assets/v1/image/network/eip155%3A8453/md"}},"buyer":{"accountCaip10":"eip155:8453:0x0000000000000000000000000000000000000000","accountProviderName":"MetaMask","accountProviderIcon":"https://api.walletconnect.com/assets/v1/image/wallet/metamask/md"},"transaction":{"networkId":"8453","hash":"0x0000000000000000000000000000000000000000000000000000000000000000"},"settlement":{"amount":{"unit":"caip19/eip155:8453/erc20:0x0000000000000000000000000000000000000000","value":"4840000","display":{"assetSymbol":"USDC","assetName":"USD Coin","decimals":6,"iconUrl":"https://api.walletconnect.com/assets/v1/image/token/USDC/md","networkName":"Base","networkIconUrl":"https://api.walletconnect.com/assets/v1/image/network/eip155%3A8453/md"}},"settled":true,"txHash":"0x0000000000000000000000000000000000000000000000000000000000000000"},"fees":{"total":{"unit":"caip19/eip155:8453/erc20:0x0000000000000000000000000000000000000000","value":"160000","display":{"assetSymbol":"USDC","assetName":"USD Coin","decimals":6,"iconUrl":"https://api.walletconnect.com/assets/v1/image/token/USDC/md","networkName":"Base","networkIconUrl":"https://api.walletconnect.com/assets/v1/image/network/eip155%3A8453/md"}},"fixed":{"unit":"caip19/eip155:8453/erc20:0x0000000000000000000000000000000000000000","value":"140000","display":{"assetSymbol":"USDC","assetName":"USD Coin","decimals":6,"iconUrl":"https://api.walletconnect.com/assets/v1/image/token/USDC/md","networkName":"Base","networkIconUrl":"https://api.walletconnect.com/assets/v1/image/network/eip155%3A8453/md"}},"percentage":"0.4"},"refund":{"status":"fully_refunded","fullyRefundedAt":"2024-01-02T08:30:00.000Z"},"createdAt":"2024-01-01T12:00:00.000Z","expiresAt":"2024-01-01T12:15:00.000Z","lastUpdatedAt":"2024-01-01T12:00:00.000Z","settledAt":"2024-01-01T12:00:00.000Z"}],"nextCursor":null,"stats":{"totalRevenue":[{"amount":1000,"currency":"USD"}],"totalTransactions":100,"totalCustomers":25}}}}},"400":{"description":"Bad request — invalid parameters or API version","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["invalid_params","params_validation","invalid_api_version","unknown_api_version","api_version_downgrade"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"issues":{"description":"Field-level validation issues (present on validation errors)","type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"]}}},"required":["message","code"]},"examples":{"invalid_params":{"summary":"Invalid request parameters","value":{"code":"invalid_params","message":"Invalid request parameters"}},"params_validation":{"summary":"Validation failed","value":{"code":"params_validation","message":"Validation failed"}},"invalid_api_version":{"summary":"Invalid API version","value":{"code":"invalid_api_version","message":"Invalid API version"}},"unknown_api_version":{"summary":"Unknown API version","value":{"code":"unknown_api_version","message":"Unknown API version"}},"api_version_downgrade":{"summary":"Requested API version is older than the partner pin","value":{"code":"api_version_downgrade","message":"Requested API version is older than the partner pin"}}}}}},"401":{"description":"Unauthorized — missing or invalid API key, or missing merchant id","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["missing_api_key","invalid_api_key","missing_merchant_id"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"code":"missing_api_key","message":"Missing API key"}},"invalid_api_key":{"summary":"Invalid API key","value":{"code":"invalid_api_key","message":"Invalid API key"}},"missing_merchant_id":{"summary":"Missing Merchant ID","value":{"code":"missing_merchant_id","message":"Missing Merchant ID"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"internal_error","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"internal_error":{"summary":"Internal Server Error","value":{"code":"internal_error","message":"Internal Server Error"}}}}}}},"tags":["Payments"],"summary":"List payments for a merchant","description":"Retrieve paginated payments with optional filters.","servers":[{"url":"https://api.merchant.pay.walletconnect.com"}],"security":[{"apiKey":[]}]}},"/v1/merchants/payments/{paymentId}/receipt":{"post":{"operationId":"PaymentReceipts_send","parameters":[{"name":"Merchant-Id","in":"header","required":true,"description":"Merchant identifier.","schema":{"type":"string","examples":["acme-store-1"]}},{"name":"WCP-Version","in":"header","required":false,"description":"Optional WalletConnect Pay API version override. If omitted, the partner's pinned version is used.","schema":{"type":"string","examples":["2026-02-18","2026-02-19.preview"]}},{"in":"path","name":"paymentId","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^pay_[A-Za-z0-9]+$","examples":["pay_a1a2ecc101KGF210FP7PN3BK08PZARS1CZ"]},"required":true,"description":"Payment ID to send the receipt for"}],"responses":{"200":{"description":"Receipt sent, or already sent before","headers":{"WCP-Version":{"description":"WalletConnect Pay API version resolved for this request.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"paymentId":{"type":"string","description":"Payment ID the receipt is for"},"status":{"type":"string","enum":["sent","already_sent"],"description":"`sent`: the receipt is on its way. `already_sent`: a receipt for this payment was already sent, so no new email was sent."}},"required":["paymentId","status"]},"example":{"paymentId":"pay_a1a2ecc101KGF210FP7PN3BK08PZARS1CZ","status":"sent"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["params_validation","payment_not_succeeded","invalid_api_version","unknown_api_version","api_version_downgrade"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"issues":{"description":"Field-level validation issues (present on validation errors)","type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"]}}},"required":["message","code"]},"examples":{"params_validation":{"summary":"Validation failed","value":{"code":"params_validation","message":"Validation failed"}},"payment_not_succeeded":{"summary":"Payment is not in a refundable state","value":{"code":"payment_not_succeeded","message":"Payment is not in a refundable state"}},"invalid_api_version":{"summary":"Invalid API version","value":{"code":"invalid_api_version","message":"Invalid API version"}},"unknown_api_version":{"summary":"Unknown API version","value":{"code":"unknown_api_version","message":"Unknown API version"}},"api_version_downgrade":{"summary":"Requested API version is older than the partner pin","value":{"code":"api_version_downgrade","message":"Requested API version is older than the partner pin"}}}}}},"401":{"description":"Unauthorized — missing or invalid API key, or missing merchant id","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["missing_api_key","invalid_api_key","missing_merchant_id"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"code":"missing_api_key","message":"Missing API key"}},"invalid_api_key":{"summary":"Invalid API key","value":{"code":"invalid_api_key","message":"Invalid API key"}},"missing_merchant_id":{"summary":"Missing Merchant ID","value":{"code":"missing_merchant_id","message":"Missing Merchant ID"}}}}}},"404":{"description":"Payment not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"not_found","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"not_found":{"summary":"Not Found","value":{"code":"not_found","message":"Not Found"}}}}}},"409":{"description":"The payment has no on-chain transaction to put on a receipt","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"receipt_unavailable","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"receipt_unavailable":{"summary":"This payment has no on-chain transaction to put on a receipt","value":{"code":"receipt_unavailable","message":"This payment has no on-chain transaction to put on a receipt"}}}}}},"429":{"description":"Too many receipt requests","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"rate_limited","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"rate_limited":{"summary":"Too Many Requests","value":{"code":"rate_limited","message":"Too Many Requests"}}}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"internal_error","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"internal_error":{"summary":"Internal Server Error","value":{"code":"internal_error","message":"Internal Server Error"}}}}}},"502":{"description":"Receipt service unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"receipt_service_unavailable","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"receipt_service_unavailable":{"summary":"The receipt service is unavailable","value":{"code":"receipt_service_unavailable","message":"The receipt service is unavailable"}}}}}}},"tags":["Payments"],"summary":"Email a payment receipt","description":"Email the receipt for a succeeded payment to the customer. A payment gets at most one receipt: if the customer already received one, no new email is sent and the response status is `already_sent`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","maxLength":320,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$","description":"Customer email address to send the receipt to","examples":["customer@example.com"]}},"required":["email"]}}}},"servers":[{"url":"https://api.merchant.pay.walletconnect.com"}],"security":[{"apiKey":[]}]}},"/v1/merchants":{"post":{"operationId":"MerchantManagement_create","tags":["Merchant Management"],"summary":"Create a merchant","description":"Create a new merchant under the authenticated partner. Requires an `Idempotency-Key` header so retries safely return the originally-created merchant rather than creating duplicates.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Unique key to ensure idempotent request processing. Max 255 characters.","schema":{"type":"string","maxLength":255}}],"responses":{"201":{"description":"Merchant created","content":{"application/json":{"schema":{"type":"object","properties":{"merchant":{"type":"object","properties":{"id":{"type":"string","description":"Merchant ID","examples":["mrch_7kBz2qR9xPvLmN4Yw"]},"name":{"type":"string","description":"Merchant display name"},"email":{"description":"Contact email","examples":["billing@acme.store"],"type":["string","null"]},"status":{"type":"string","enum":["active","inactive","suspended"],"description":"Current merchant status","examples":["active"]},"mcc":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"ISO 18245 merchant category code, or null if not set","examples":[5812]},"createdAt":{"type":"string","description":"ISO 8601 creation timestamp","examples":["2025-06-15T10:30:00.000Z"]}},"required":["id","name","email","status","mcc","createdAt"]}},"required":["merchant"]},"example":{"merchant":{"id":"mrch_7kBz2qR9xPvLmN4Yw","name":"Acme Store","email":"billing@acme.store","status":"active","mcc":5812,"createdAt":"2025-06-15T10:30:00.000Z"}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["params_validation","invalid_params","missing_idempotency_key","logo_too_small","logo_too_large","logo_not_square","logo_file_too_big","logo_invalid_mime","logo_invalid_dimensions"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"issues":{"description":"Field-level validation issues (present on validation errors)","type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"]}}},"required":["message","code"]},"examples":{"params_validation":{"summary":"Validation failed","value":{"code":"params_validation","message":"Validation failed"}},"invalid_params":{"summary":"Invalid request parameters","value":{"code":"invalid_params","message":"Invalid request parameters"}},"missing_idempotency_key":{"summary":"Missing Idempotency-Key header","value":{"code":"missing_idempotency_key","message":"Missing Idempotency-Key header"}},"logo_too_small":{"summary":"Logo is too small","value":{"code":"logo_too_small","message":"Logo is too small"}},"logo_too_large":{"summary":"Logo is too large","value":{"code":"logo_too_large","message":"Logo is too large"}},"logo_not_square":{"summary":"Logo must be square","value":{"code":"logo_not_square","message":"Logo must be square"}},"logo_file_too_big":{"summary":"Logo file is too large","value":{"code":"logo_file_too_big","message":"Logo file is too large"}},"logo_invalid_mime":{"summary":"Logo file type is not supported","value":{"code":"logo_invalid_mime","message":"Logo file type is not supported"}},"logo_invalid_dimensions":{"summary":"Logo dimensions could not be read","value":{"code":"logo_invalid_dimensions","message":"Logo dimensions could not be read"}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"code":"missing_api_key","message":"Missing API key"}},"invalid_api_key":{"summary":"Invalid API key","value":{"code":"invalid_api_key","message":"Invalid API key"}}}}}},"409":{"description":"Idempotency conflict","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"idempotency_conflict","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"idempotency_conflict":{"summary":"Idempotency key conflict: same key was used with a different request body","value":{"code":"idempotency_conflict","message":"Idempotency key conflict: same key was used with a different request body"}}}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"internal_error","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"internal_error":{"summary":"Internal Server Error","value":{"code":"internal_error","message":"Internal Server Error"}}}}}},"502":{"description":"Bad gateway","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"bad_gateway","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"bad_gateway":{"summary":"Bad Gateway","value":{"code":"bad_gateway","message":"Bad Gateway"}}}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"merchantName":{"type":"string","minLength":2,"maxLength":64,"description":"Display name for the merchant","examples":["Acme Store"]},"merchantEmail":{"type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$","description":"Contact email for the merchant","examples":["billing@acme.store"]},"iconUrl":{"default":null,"description":"Merchant logo URL (HTTPS only), or null to unset. Logo should be square (1:1, ±5%), 500×500px minimum (1024×1024px recommended, 4096×4096px maximum), JPEG/PNG/WebP, up to 2 MB.","examples":["https://example.com/logo.png"],"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"alwaysCollectData":{"description":"When true, every checkout forces the buyer to provide compliance data, even repeat buyers whose data is already on file.","examples":[true],"type":"boolean"},"mcc":{"default":null,"description":"ISO 18245 merchant category code describing the merchant's line of business.","examples":[5812],"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["merchantName","merchantEmail"],"examples":[{"merchantName":"Acme Store","merchantEmail":"billing@acme.store","iconUrl":"https://example.com/logo.png"}]}}}},"servers":[{"url":"https://api.merchant.pay.walletconnect.com"}],"security":[{"apiKey":[]}]},"get":{"operationId":"MerchantManagement_list","tags":["Merchant Management"],"summary":"List merchants","description":"List the partner's merchants. Supports filtering by `status`, free-text `search` over name and ID, and cursor-based pagination via `cursor` and `limit`.","responses":{"200":{"description":"Merchants list","content":{"application/json":{"schema":{"type":"object","properties":{"merchants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Merchant ID","examples":["mrch_7kBz2qR9xPvLmN4Yw"]},"name":{"type":"string","description":"Merchant display name"},"email":{"description":"Contact email","examples":["billing@acme.store"],"type":["string","null"]},"status":{"type":"string","enum":["active","inactive","suspended"],"description":"Current merchant status","examples":["active"]},"iconUrl":{"description":"Merchant logo URL, or null if not set","examples":["https://imagedelivery.net/example/acme-icon.png"],"type":["string","null"]},"mcc":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"ISO 18245 merchant category code, or null if not set","examples":[5812]},"createdAt":{"type":"string","description":"ISO 8601 creation timestamp","examples":["2025-06-15T10:30:00.000Z"]}},"required":["id","name","email","status","iconUrl","mcc","createdAt"]}},"totalCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Total number of merchants matching the query (ignoring pagination)"},"nextCursor":{"description":"Cursor for the next page, or null if no more results","type":["string","null"]}},"required":["merchants","totalCount","nextCursor"]},"example":{"merchants":[{"id":"mrch_7kBz2qR9xPvLmN4Yw","name":"Acme Store","email":"billing@acme.store","status":"active","iconUrl":"https://imagedelivery.net/example/acme-icon.png","mcc":5812,"createdAt":"2025-06-15T10:30:00.000Z"},{"id":"mrch_Qx8fTp3YwKjR5vNm2","name":"Widget Co","email":null,"status":"active","iconUrl":null,"mcc":null,"createdAt":"2025-07-01T08:00:00.000Z"}],"totalCount":2,"nextCursor":null}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["params_validation","invalid_params"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"issues":{"description":"Field-level validation issues (present on validation errors)","type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"]}}},"required":["message","code"]},"examples":{"params_validation":{"summary":"Validation failed","value":{"code":"params_validation","message":"Validation failed"}},"invalid_params":{"summary":"Invalid request parameters","value":{"code":"invalid_params","message":"Invalid request parameters"}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"code":"missing_api_key","message":"Missing API key"}},"invalid_api_key":{"summary":"Invalid API key","value":{"code":"invalid_api_key","message":"Invalid API key"}}}}}}},"parameters":[{"in":"query","name":"status","schema":{"type":"string","enum":["active","inactive","suspended"]},"description":"Filter by merchant status"},{"in":"query","name":"search","schema":{"examples":["Acme"],"type":"string","minLength":1,"maxLength":256},"description":"Search by merchant name or ID (case-insensitive)"},{"in":"query","name":"cursor","schema":{"type":"string"},"description":"Opaque pagination cursor — use the value from `nextCursor` in the previous response."},{"in":"query","name":"limit","schema":{"default":20,"type":"integer","minimum":1,"maximum":100},"description":"Page size (default 20, max 100)"}],"servers":[{"url":"https://api.merchant.pay.walletconnect.com"}],"security":[{"apiKey":[]}]}},"/v1/merchants/{merchantId}":{"get":{"operationId":"MerchantManagement_get","tags":["Merchant Management"],"summary":"Get a merchant","description":"Fetch a merchant's profile along with its configured `settlements` (crypto and fiat). Crypto settlements use [CAIP-19](https://chainagnostic.org/CAIPs/caip-19) asset IDs and [CAIP-10](https://chainagnostic.org/CAIPs/caip-10) destination accounts.","responses":{"200":{"description":"Merchant details","content":{"application/json":{"schema":{"type":"object","properties":{"merchant":{"type":"object","properties":{"id":{"type":"string","description":"Merchant ID","examples":["mrch_7kBz2qR9xPvLmN4Yw"]},"name":{"type":"string","description":"Merchant display name"},"email":{"description":"Contact email","examples":["billing@acme.store"],"type":["string","null"]},"status":{"type":"string","enum":["active","inactive","suspended"],"description":"Current merchant status","examples":["active"]},"iconUrl":{"description":"Merchant logo URL, or null if not set","examples":["https://imagedelivery.net/example/acme-icon.png"],"type":["string","null"]},"mcc":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"ISO 18245 merchant category code, or null if not set","examples":[5812]},"createdAt":{"type":"string","description":"ISO 8601 creation timestamp","examples":["2025-06-15T10:30:00.000Z"]},"alwaysCollectData":{"type":"boolean","description":"When true, every checkout forces the buyer to provide compliance data — even repeat buyers whose data is already on file.","examples":[false]},"mtaAddresses":{"type":"array","items":{"type":"string"},"description":"Transit account addresses, where payments arrive before they settle, as [CAIP-10](https://standards.chainagnostic.org/CAIPs/caip-10) account IDs. One entry per provisioned chain, and chains in a namespace share an address, so entries repeat. Empty when there is no transit account. May be shared across all of a partner's merchants, so they cannot be used to attribute a payment to a single merchant.","examples":[["eip155:8453:0x1234567890abcdef1234567890abcdef12345678","eip155:10:0x1234567890abcdef1234567890abcdef12345678"]]},"settlements":{"type":"object","properties":{"crypto":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Crypto settlement ID"},"asset":{"type":"string","description":"[CAIP-19](https://standards.chainagnostic.org/CAIPs/caip-19) asset ID","examples":["eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"]},"destination":{"type":"string","description":"[CAIP-10](https://standards.chainagnostic.org/CAIPs/caip-10) settlement destination","examples":["eip155:8453:0x1234567890abcdef1234567890abcdef12345678"]},"networkName":{"description":"Display name of the settlement network, or null if the chain is not recognized","examples":["Base"],"type":["string","null"]},"networkLogoUrl":{"description":"Logo URL for the settlement network (an admin-uploaded logo when set, otherwise the assets-registry fallback), or null if the chain is not recognized","examples":["https://api.walletconnect.com/assets/v1/image/network/eip155%3A8453/md"],"type":["string","null"]}},"required":["id","asset","destination","networkName","networkLogoUrl"]}},"fiat":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Settlement config ID"},"status":{"type":"string","description":"Fiat settlement status"},"bankType":{"type":"string","description":"Bank account type"}},"required":["id","status","bankType"]}},"hasSettlementPath":{"type":"boolean","description":"True when the merchant has somewhere for a live payment to settle: a crypto settlement, a fiat settlement config (including one still in setup, and so absent from `fiat` above), or an enabled funding source. Use this rather than the arrays above to decide whether the merchant is payable — they list only what is active. Advisory: pay-core is the authority and rejects a payment it cannot settle with `no_settlement_configuration`."}},"required":["crypto","fiat","hasSettlementPath"]}},"required":["id","name","email","status","iconUrl","mcc","createdAt","alwaysCollectData","mtaAddresses","settlements"]}},"required":["merchant"]},"example":{"merchant":{"id":"mrch_7kBz2qR9xPvLmN4Yw","name":"Acme Store","email":"billing@acme.store","status":"active","iconUrl":"https://imagedelivery.net/example/acme-icon.png","mcc":5812,"createdAt":"2025-06-15T10:30:00.000Z","mtaAddresses":["eip155:8453:0x1234567890abcdef1234567890abcdef12345678","eip155:10:0x1234567890abcdef1234567890abcdef12345678"],"settlements":{"crypto":[{"id":"crypto_Xk7nWp8XmQj2YrTv6","asset":"eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","destination":"eip155:8453:0x1234567890abcdef1234567890abcdef12345678","networkName":"Base","networkLogoUrl":"https://api.walletconnect.com/assets/v1/image/network/eip155%3A8453/md"}],"fiat":[{"id":"fiat_Bk4nWp8XmQj2YrTv6","status":"active","bankType":"ACH"}]}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"code":"missing_api_key","message":"Missing API key"}},"invalid_api_key":{"summary":"Invalid API key","value":{"code":"invalid_api_key","message":"Invalid API key"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"not_found","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"not_found":{"summary":"Not Found","value":{"code":"not_found","message":"Not Found"}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"merchantId","required":true}],"servers":[{"url":"https://api.merchant.pay.walletconnect.com"}],"security":[{"apiKey":[]}]},"patch":{"operationId":"MerchantManagement_update","tags":["Merchant Management"],"summary":"Update a merchant","description":"Update a merchant's profile. At least one of `merchantName`, `merchantEmail`, `iconUrl`, `alwaysCollectData`, or `mcc` must be provided. Pass `iconUrl: null` to unset the existing logo, and `mcc: null` to unset the merchant category code.","responses":{"200":{"description":"Merchant updated","content":{"application/json":{"schema":{"type":"object","properties":{"merchant":{"type":"object","properties":{"id":{"type":"string","description":"Merchant ID","examples":["mrch_7kBz2qR9xPvLmN4Yw"]},"name":{"type":"string","description":"Merchant display name"},"email":{"description":"Contact email","examples":["billing@acme.store"],"type":["string","null"]},"status":{"type":"string","enum":["active","inactive","suspended"],"description":"Current merchant status","examples":["active"]},"iconUrl":{"description":"Merchant logo URL, or null if not set","examples":["https://imagedelivery.net/example/acme-icon.png"],"type":["string","null"]},"mcc":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"ISO 18245 merchant category code, or null if not set","examples":[5812]},"createdAt":{"type":"string","description":"ISO 8601 creation timestamp","examples":["2025-06-15T10:30:00.000Z"]}},"required":["id","name","email","status","iconUrl","mcc","createdAt"]}},"required":["merchant"]},"example":{"merchant":{"id":"mrch_7kBz2qR9xPvLmN4Yw","name":"Acme Store v2","email":"billing@acme.store","status":"active","iconUrl":"https://imagedelivery.net/example/acme-icon.png","mcc":5812,"createdAt":"2025-06-15T10:30:00.000Z"}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["params_validation","invalid_params","logo_too_small","logo_too_large","logo_not_square","logo_file_too_big","logo_invalid_mime","logo_invalid_dimensions"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"issues":{"description":"Field-level validation issues (present on validation errors)","type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"]}}},"required":["message","code"]},"examples":{"params_validation":{"summary":"Validation failed","value":{"code":"params_validation","message":"Validation failed"}},"invalid_params":{"summary":"Invalid request parameters","value":{"code":"invalid_params","message":"Invalid request parameters"}},"logo_too_small":{"summary":"Logo is too small","value":{"code":"logo_too_small","message":"Logo is too small"}},"logo_too_large":{"summary":"Logo is too large","value":{"code":"logo_too_large","message":"Logo is too large"}},"logo_not_square":{"summary":"Logo must be square","value":{"code":"logo_not_square","message":"Logo must be square"}},"logo_file_too_big":{"summary":"Logo file is too large","value":{"code":"logo_file_too_big","message":"Logo file is too large"}},"logo_invalid_mime":{"summary":"Logo file type is not supported","value":{"code":"logo_invalid_mime","message":"Logo file type is not supported"}},"logo_invalid_dimensions":{"summary":"Logo dimensions could not be read","value":{"code":"logo_invalid_dimensions","message":"Logo dimensions could not be read"}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"code":"missing_api_key","message":"Missing API key"}},"invalid_api_key":{"summary":"Invalid API key","value":{"code":"invalid_api_key","message":"Invalid API key"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"not_found","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"not_found":{"summary":"Not Found","value":{"code":"not_found","message":"Not Found"}}}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"merchantName":{"description":"Updated display name","examples":["Acme Store v2"],"type":"string","minLength":2,"maxLength":64},"merchantEmail":{"description":"Updated contact email","examples":["new-billing@acme.store"],"type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"iconUrl":{"description":"Updated logo URL (HTTPS only), or null to unset. Logo should be square (1:1, ±5%), 500×500px minimum (1024×1024px recommended, 4096×4096px maximum), JPEG/PNG/WebP, up to 2 MB.","examples":["https://example.com/new-logo.png"],"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"alwaysCollectData":{"description":"When true, every checkout forces the buyer to provide compliance data, even repeat buyers whose data is already on file.","examples":[true],"type":"boolean"},"mcc":{"description":"Updated ISO 18245 merchant category code, or null to unset.","examples":[5812],"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"merchantId","required":true}],"servers":[{"url":"https://api.merchant.pay.walletconnect.com"}],"security":[{"apiKey":[]}]},"delete":{"operationId":"MerchantManagement_delete","tags":["Merchant Management"],"summary":"Delete a merchant","description":"Soft-delete a merchant. The merchant is hidden from listings and can no longer accept new payments. Already-deleted merchants return `deleted: true` so the call is idempotent.","responses":{"200":{"description":"Merchant deleted","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Merchant ID"},"deleted":{"type":"boolean","description":"Whether the merchant was successfully deleted"}},"required":["id","deleted"]},"example":{"id":"mrch_7kBz2qR9xPvLmN4Yw","deleted":true}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"code":"missing_api_key","message":"Missing API key"}},"invalid_api_key":{"summary":"Invalid API key","value":{"code":"invalid_api_key","message":"Invalid API key"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"not_found","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"not_found":{"summary":"Not Found","value":{"code":"not_found","message":"Not Found"}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"merchantId","required":true}],"servers":[{"url":"https://api.merchant.pay.walletconnect.com"}],"security":[{"apiKey":[]}]}},"/v1/merchants/{merchantId}/settlements":{"get":{"operationId":"Settlements_list","tags":["Settlements"],"summary":"List settlements","description":"List the merchant's configured fiat and crypto settlement destinations.","responses":{"200":{"description":"Settlements list","content":{"application/json":{"schema":{"type":"object","properties":{"fiat":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"string","description":"Fiat settlement ID","examples":["fiat_Bk4nWp8XmQj2YrTv6"]},"status":{"type":"string","description":"Fiat settlement status. Collapses the KYB lifecycle into broad partner-facing states (`pending_kyb`, `action_required`, `active`, `rejected`). See `kybStatus` for the raw KYB state.","examples":["active"]},"kybStatus":{"description":"Raw KYB lifecycle state from the verification provider. Distinguishes `collecting_info` (waiting on merchant to start) from `pending` (verification in flight) — both collapse to `pending_kyb` under `status`. `null` when no KYB case is linked.","examples":["pending"],"type":["string","null"]},"kybUrl":{"description":"URL the merchant must visit to continue verification: Iron's hosted identity flow during KYB, or our hosted token-gated signing page once Iron requires document signatures. `null` when no merchant action is pending.","examples":["https://kyb.iron.io/verify/abc123"],"type":["string","null"]},"bankType":{"type":"string","const":"SEPA","description":"Bank account type"},"bankName":{"type":"string","description":"Display name of the bank.","examples":["BNP Paribas"]},"bankCountry":{"type":"string","description":"ISO 3166-1 alpha-2 country code of the bank.","examples":["FR"]},"accountHolderName":{"description":"Account holder name as recorded on the bank account.","examples":["Acme Corp SAS"],"type":["string","null"]},"ibanLast4":{"type":"string","description":"Last 4 characters of the IBAN. The full IBAN is never returned over the API.","examples":["0189"]}},"required":["id","status","kybStatus","kybUrl","bankType","bankName","bankCountry","accountHolderName","ibanLast4"]},{"type":"object","properties":{"id":{"type":"string","description":"Fiat settlement ID","examples":["fiat_Bk4nWp8XmQj2YrTv6"]},"status":{"type":"string","description":"Fiat settlement status. Collapses the KYB lifecycle into broad partner-facing states (`pending_kyb`, `action_required`, `active`, `rejected`). See `kybStatus` for the raw KYB state.","examples":["active"]},"kybStatus":{"description":"Raw KYB lifecycle state from the verification provider. Distinguishes `collecting_info` (waiting on merchant to start) from `pending` (verification in flight) — both collapse to `pending_kyb` under `status`. `null` when no KYB case is linked.","examples":["pending"],"type":["string","null"]},"kybUrl":{"description":"URL the merchant must visit to continue verification: Iron's hosted identity flow during KYB, or our hosted token-gated signing page once Iron requires document signatures. `null` when no merchant action is pending.","examples":["https://kyb.iron.io/verify/abc123"],"type":["string","null"]},"bankType":{"type":"string","const":"ACH","description":"Bank account type"},"bankName":{"type":"string","description":"Display name of the bank.","examples":["Chase"]},"bankCountry":{"type":"string","description":"ISO 3166-1 alpha-2 country code of the bank.","examples":["US"]},"accountHolderName":{"description":"Account holder name as recorded on the bank account.","examples":["Acme Corp Inc"],"type":["string","null"]},"routingNumber":{"type":"string","description":"ABA routing number. Returned in full — it identifies the bank, not the account.","examples":["021000021"]},"accountLast4":{"type":"string","description":"Last 4 characters of the bank account number. The full account number is never returned over the API.","examples":["6789"]}},"required":["id","status","kybStatus","kybUrl","bankType","bankName","bankCountry","accountHolderName","routingNumber","accountLast4"]},{"type":"object","properties":{"id":{"type":"string","description":"Fiat settlement ID","examples":["fiat_Bk4nWp8XmQj2YrTv6"]},"status":{"type":"string","description":"Fiat settlement status. Collapses the KYB lifecycle into broad partner-facing states (`pending_kyb`, `action_required`, `active`, `rejected`). See `kybStatus` for the raw KYB state.","examples":["active"]},"kybStatus":{"description":"Raw KYB lifecycle state from the verification provider. Distinguishes `collecting_info` (waiting on merchant to start) from `pending` (verification in flight) — both collapse to `pending_kyb` under `status`. `null` when no KYB case is linked.","examples":["pending"],"type":["string","null"]},"kybUrl":{"description":"URL the merchant must visit to continue verification: Iron's hosted identity flow during KYB, or our hosted token-gated signing page once Iron requires document signatures. `null` when no merchant action is pending.","examples":["https://kyb.iron.io/verify/abc123"],"type":["string","null"]},"bankType":{"type":"string","const":"unknown","description":"Bank account type. `unknown` when no bank account is linked yet."}},"required":["id","status","kybStatus","kybUrl","bankType"]}]},"description":"Fiat settlement configurations attached to the merchant."},"crypto":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Crypto settlement ID","examples":["crypto_Xk7nWp8XmQj2YrTv6"]},"asset":{"type":"string","description":"[CAIP-19](https://chainagnostic.org/CAIPs/caip-19) asset identifier","examples":["eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"]},"destination":{"type":"string","description":"[CAIP-10](https://chainagnostic.org/CAIPs/caip-10) destination wallet","examples":["eip155:8453:0x1234567890abcdef1234567890abcdef12345678"]},"networkName":{"description":"Display name of the settlement network, or null if the chain is not recognized","examples":["Base"],"type":["string","null"]},"networkLogoUrl":{"description":"Logo URL for the settlement network (an admin-uploaded logo when set, otherwise the assets-registry fallback), or null if the chain is not recognized","examples":["https://api.walletconnect.com/assets/v1/image/network/eip155%3A8453/md"],"type":["string","null"]}},"required":["id","asset","destination","networkName","networkLogoUrl"]},"description":"Crypto settlement destinations attached to the merchant."}},"required":["fiat","crypto"]},"example":{"fiat":[{"id":"fiat_Bk4nWp8XmQj2YrTv6","status":"active","kybStatus":"approved","kybUrl":null,"bankType":"ACH","bankName":"Chase","bankCountry":"US","accountHolderName":"Acme Corp Inc","routingNumber":"021000021","accountLast4":"6789"}],"crypto":[{"id":"crypto_Xk7nWp8XmQj2YrTv6","asset":"eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","destination":"eip155:8453:0x1234567890abcdef1234567890abcdef12345678","networkName":"Base","networkLogoUrl":"https://api.walletconnect.com/assets/v1/image/network/eip155%3A8453/md"}]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"code":"missing_api_key","message":"Missing API key"}},"invalid_api_key":{"summary":"Invalid API key","value":{"code":"invalid_api_key","message":"Invalid API key"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"not_found","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"not_found":{"summary":"Not Found","value":{"code":"not_found","message":"Not Found"}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"merchantId","required":true}],"servers":[{"url":"https://api.merchant.pay.walletconnect.com"}],"security":[{"apiKey":[]}]}},"/v1/merchants/{merchantId}/settlements/tokens":{"get":{"operationId":"Settlements_listAvailableTokens","tags":["Settlements"],"summary":"List tokens available for settlement","description":"List the tokens this merchant may currently settle in, freshly resolved per request: every asset returned passes the `token_not_enabled` gate on the crypto settlement write endpoints. Derive settlement requests from this list rather than from a platform-wide catalogue. An asset that already has a settlement pair, in any status, still returns `settlement_asset_conflict` on create. `internal_error` means enablement could not be resolved — retry shortly.","responses":{"200":{"description":"Tokens available for settlement","content":{"application/json":{"schema":{"type":"object","properties":{"tokens":{"type":"array","items":{"type":"object","properties":{"asset":{"type":"string","description":"[CAIP-19](https://chainagnostic.org/CAIPs/caip-19) asset identifier","examples":["eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"]},"caip2ChainId":{"type":"string","description":"[CAIP-2](https://chainagnostic.org/CAIPs/caip-2) chain the token settles on","examples":["eip155:8453"]},"symbol":{"type":"string","description":"Token symbol","examples":["USDC"]},"name":{"type":"string","description":"Token display name","examples":["USD Coin"]},"decimals":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Token decimals","examples":[6]},"logoUrl":{"description":"Token logo URL, or null when none is registered","examples":["https://api.walletconnect.com/assets/v1/image/token/USDC/md"],"type":["string","null"]},"networkName":{"description":"Display name of the settlement network, or null if the chain is not recognized","examples":["Base"],"type":["string","null"]},"networkLogoUrl":{"description":"Logo URL for the settlement network (an admin-uploaded logo when set, otherwise the assets-registry fallback), or null if the chain is not recognized","examples":["https://api.walletconnect.com/assets/v1/image/network/eip155%3A8453/md"],"type":["string","null"]}},"required":["asset","caip2ChainId","symbol","name","decimals","logoUrl","networkName","networkLogoUrl"]},"description":"Tokens the merchant may settle in. Empty when no tokens are currently enabled for this merchant."}},"required":["tokens"]},"example":{"tokens":[{"asset":"eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","caip2ChainId":"eip155:8453","symbol":"USDC","name":"USD Coin","decimals":6,"logoUrl":"https://api.walletconnect.com/assets/v1/image/token/USDC/md","networkName":"Base","networkLogoUrl":"https://api.walletconnect.com/assets/v1/image/network/eip155%3A8453/md"}]}}}},"400":{"description":"Settlement management is not available for test partners","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"invalid_params","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"invalid_params":{"summary":"Invalid request parameters","value":{"code":"invalid_params","message":"Invalid request parameters"}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"code":"missing_api_key","message":"Missing API key"}},"invalid_api_key":{"summary":"Invalid API key","value":{"code":"invalid_api_key","message":"Invalid API key"}}}}}},"404":{"description":"Merchant not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"not_found","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"not_found":{"summary":"Not Found","value":{"code":"not_found","message":"Not Found"}}}}}},"500":{"description":"Token enablement could not be resolved","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"internal_error","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"internal_error":{"summary":"Internal Server Error","value":{"code":"internal_error","message":"Internal Server Error"}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"merchantId","required":true}],"servers":[{"url":"https://api.merchant.pay.walletconnect.com"}],"security":[{"apiKey":[]}]}},"/v1/merchants/{merchantId}/settlements/crypto":{"post":{"operationId":"CryptoSettlement_create","tags":["Crypto Settlement"],"summary":"Create crypto settlements","description":"Register one or more crypto settlement destinations for the merchant. Each entry pairs a [CAIP-19](https://chainagnostic.org/CAIPs/caip-19) `asset` with a [CAIP-10](https://chainagnostic.org/CAIPs/caip-10) `destination` wallet on the same chain. Each `(merchant, asset)` pair must be unique — registering the same asset twice returns `settlement_asset_conflict`. Crypto and fiat settlements can coexist on the same merchant. Assets must be enabled for the merchant; if any is not, the whole request is rejected with `token_not_enabled` naming every offending asset. Stellar destinations must be ready to receive their asset — the account must exist on the ledger and hold a trustline for the asset's issuer — otherwise the request is rejected with `settlement_destination_not_ready`.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Unique key to ensure idempotent request processing. Max 255 characters.","schema":{"type":"string","maxLength":255}},{"schema":{"type":"string"},"in":"path","name":"merchantId","required":true}],"responses":{"201":{"description":"Crypto settlements created","content":{"application/json":{"schema":{"type":"object","properties":{"settlements":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Crypto settlement ID","examples":["crypto_Xk7nWp8XmQj2YrTv6"]},"asset":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[-a-zA-Z0-9]{3,8}:[-a-zA-Z0-9]{1,32}\\/[-a-zA-Z0-9]{3,8}:[-a-zA-Z0-9]{1,128}$","description":"[CAIP-19](https://chainagnostic.org/CAIPs/caip-19) asset identifier for the token to settle in. Format: `:/:`. For example, USDC on Base is `eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`.","examples":["eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"]},"destination":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[-a-zA-Z0-9]{3,8}:[-a-zA-Z0-9]{1,32}:[-a-zA-Z0-9]{1,128}$","description":"[CAIP-10](https://chainagnostic.org/CAIPs/caip-10) account identifier for the wallet that should receive the settled funds. Format: `::

`. The chain (`:`) must match the chain of the corresponding `asset`.","examples":["eip155:8453:0x1234567890abcdef1234567890abcdef12345678"]}},"required":["id","asset","destination"]}}},"required":["settlements"]},"example":{"settlements":[{"id":"crypto_Xk7nWp8XmQj2YrTv6","asset":"eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","destination":"eip155:8453:0x1234567890abcdef1234567890abcdef12345678"}]}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["params_validation","invalid_params","missing_idempotency_key","token_not_enabled"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"issues":{"description":"Field-level validation issues (present on validation errors)","type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"]}}},"required":["message","code"]},"examples":{"params_validation":{"summary":"Validation failed","value":{"code":"params_validation","message":"Validation failed"}},"invalid_params":{"summary":"Invalid request parameters","value":{"code":"invalid_params","message":"Invalid request parameters"}},"missing_idempotency_key":{"summary":"Missing Idempotency-Key header","value":{"code":"missing_idempotency_key","message":"Missing Idempotency-Key header"}},"token_not_enabled":{"summary":"This token is not enabled for this merchant yet","value":{"code":"token_not_enabled","message":"This token is not enabled for this merchant yet"}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"code":"missing_api_key","message":"Missing API key"}},"invalid_api_key":{"summary":"Invalid API key","value":{"code":"invalid_api_key","message":"Invalid API key"}}}}}},"404":{"description":"Merchant not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"not_found","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"not_found":{"summary":"Not Found","value":{"code":"not_found","message":"Not Found"}}}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["idempotency_conflict","settlement_asset_conflict","settlement_destination_not_ready"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"idempotency_conflict":{"summary":"Idempotency key conflict: same key was used with a different request body","value":{"code":"idempotency_conflict","message":"Idempotency key conflict: same key was used with a different request body"}},"settlement_asset_conflict":{"summary":"A settlement already exists for this asset","value":{"code":"settlement_asset_conflict","message":"A settlement already exists for this asset"}},"settlement_destination_not_ready":{"summary":"The settlement destination is not ready to receive this asset on its network","value":{"code":"settlement_destination_not_ready","message":"The settlement destination is not ready to receive this asset on its network"}}}}}},"502":{"description":"Stellar destination check or transit account provisioning failed; retry shortly","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"bad_gateway","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"bad_gateway":{"summary":"Bad Gateway","value":{"code":"bad_gateway","message":"Bad Gateway"}}}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"settlements":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"asset":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[-a-zA-Z0-9]{3,8}:[-a-zA-Z0-9]{1,32}\\/[-a-zA-Z0-9]{3,8}:[-a-zA-Z0-9]{1,128}$","description":"[CAIP-19](https://chainagnostic.org/CAIPs/caip-19) asset identifier for the token to settle in. Format: `:/:`. For example, USDC on Base is `eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`.","examples":["eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"]},"destination":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[-a-zA-Z0-9]{3,8}:[-a-zA-Z0-9]{1,32}:[-a-zA-Z0-9]{1,128}$","description":"[CAIP-10](https://chainagnostic.org/CAIPs/caip-10) account identifier for the wallet that should receive the settled funds. Format: `::

`. The chain (`:`) must match the chain of the corresponding `asset`.","examples":["eip155:8453:0x1234567890abcdef1234567890abcdef12345678"]}},"required":["asset","destination"]},"description":"List of asset/destination pairs to register. Up to 50 entries per request."}},"required":["settlements"],"examples":[{"settlements":[{"asset":"eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","destination":"eip155:8453:0x1234567890abcdef1234567890abcdef12345678"},{"asset":"eip155:1/erc20:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","destination":"eip155:1:0x1234567890abcdef1234567890abcdef12345678"}]}]}}}},"servers":[{"url":"https://api.merchant.pay.walletconnect.com"}],"security":[{"apiKey":[]}]}},"/v1/merchants/{merchantId}/settlements/crypto/{id}":{"put":{"operationId":"CryptoSettlement_update","tags":["Crypto Settlement"],"summary":"Update a crypto settlement destination","description":"Change the destination wallet for an existing crypto settlement. The new `destination` must be a [CAIP-10](https://chainagnostic.org/CAIPs/caip-10) account on the same chain as the settlement's `asset`.","responses":{"200":{"description":"Settlement updated","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Crypto settlement ID","examples":["crypto_Xk7nWp8XmQj2YrTv6"]},"asset":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[-a-zA-Z0-9]{3,8}:[-a-zA-Z0-9]{1,32}\\/[-a-zA-Z0-9]{3,8}:[-a-zA-Z0-9]{1,128}$","description":"[CAIP-19](https://chainagnostic.org/CAIPs/caip-19) asset identifier for the token to settle in. Format: `:/:`. For example, USDC on Base is `eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`.","examples":["eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"]},"destination":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[-a-zA-Z0-9]{3,8}:[-a-zA-Z0-9]{1,32}:[-a-zA-Z0-9]{1,128}$","description":"[CAIP-10](https://chainagnostic.org/CAIPs/caip-10) account identifier for the wallet that should receive the settled funds. Format: `::

`. The chain (`:`) must match the chain of the corresponding `asset`.","examples":["eip155:8453:0x1234567890abcdef1234567890abcdef12345678"]}},"required":["id","asset","destination"]},"example":{"id":"crypto_Xk7nWp8XmQj2YrTv6","asset":"eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","destination":"eip155:8453:0x1234567890abcdef1234567890abcdef12345678"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["params_validation","invalid_params"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"issues":{"description":"Field-level validation issues (present on validation errors)","type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"]}}},"required":["message","code"]},"examples":{"params_validation":{"summary":"Validation failed","value":{"code":"params_validation","message":"Validation failed"}},"invalid_params":{"summary":"Invalid request parameters","value":{"code":"invalid_params","message":"Invalid request parameters"}}}}}},"404":{"description":"Settlement not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"not_found","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"not_found":{"summary":"Not Found","value":{"code":"not_found","message":"Not Found"}}}}}},"409":{"description":"Destination not ready to receive the asset","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"settlement_destination_not_ready","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"settlement_destination_not_ready":{"summary":"The settlement destination is not ready to receive this asset on its network","value":{"code":"settlement_destination_not_ready","message":"The settlement destination is not ready to receive this asset on its network"}}}}}},"502":{"description":"Stellar destination check or transit account provisioning failed; retry shortly","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"bad_gateway","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"bad_gateway":{"summary":"Bad Gateway","value":{"code":"bad_gateway","message":"Bad Gateway"}}}}}}},"parameters":[{"in":"path","name":"id","schema":{"type":"string","minLength":1,"maxLength":256,"examples":["crypto_Xk7nWp8XmQj2YrTv6"]},"required":true,"description":"Crypto settlement ID"},{"schema":{"type":"string"},"in":"path","name":"merchantId","required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"destination":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[-a-zA-Z0-9]{3,8}:[-a-zA-Z0-9]{1,32}:[-a-zA-Z0-9]{1,128}$","description":"[CAIP-10](https://chainagnostic.org/CAIPs/caip-10) account identifier for the wallet that should receive the settled funds. Format: `::

`. The chain (`:`) must match the chain of the corresponding `asset`.","examples":["eip155:8453:0x1234567890abcdef1234567890abcdef12345678"]}},"required":["destination"],"examples":[{"destination":"eip155:8453:0x1234567890abcdef1234567890abcdef12345678"}]}}}},"servers":[{"url":"https://api.merchant.pay.walletconnect.com"}],"security":[{"apiKey":[]}]},"delete":{"operationId":"CryptoSettlement_delete","tags":["Crypto Settlement"],"summary":"Delete a crypto settlement","description":"Remove a crypto settlement. Future payments in the deleted asset will no longer be auto-settled.","responses":{"200":{"description":"Settlement deleted","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Crypto settlement ID"},"deleted":{"type":"boolean","description":"Whether the settlement was successfully deleted"}},"required":["id","deleted"]},"example":{"id":"crypto_Xk7nWp8XmQj2YrTv6","deleted":true}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"invalid_params","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"invalid_params":{"summary":"Invalid request parameters","value":{"code":"invalid_params","message":"Invalid request parameters"}}}}}},"404":{"description":"Settlement not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"not_found","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"not_found":{"summary":"Not Found","value":{"code":"not_found","message":"Not Found"}}}}}}},"parameters":[{"in":"path","name":"id","schema":{"type":"string","minLength":1,"maxLength":256,"examples":["crypto_Xk7nWp8XmQj2YrTv6"]},"required":true,"description":"Crypto settlement ID"},{"schema":{"type":"string"},"in":"path","name":"merchantId","required":true}],"servers":[{"url":"https://api.merchant.pay.walletconnect.com"}],"security":[{"apiKey":[]}]}},"/v1/merchants/{merchantId}/settlements/fiat":{"post":{"operationId":"FiatSettlement_create","tags":["Fiat Settlement"],"summary":"Create a fiat settlement","description":"Register a fiat settlement route for the merchant and kick off KYB verification. The response includes a `kybUrl` that the partner must surface to their merchant — fiat routing is only fully activated once KYB is approved. Currency is determined by `bankType`: SEPA settles in EUR, ACH in USD. ACH additionally requires a US business address and a valid US state code. Re-submitting with the same `Idempotency-Key` returns the original result; submitting a different payload under the same key returns `idempotency_conflict`. Attempting to register a bank account that already exists for the merchant returns `settlement_conflict` — delete the existing settlement first or update it via PATCH.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Unique key to ensure idempotent request processing. Max 255 characters.","schema":{"type":"string","maxLength":255}},{"schema":{"type":"string"},"in":"path","name":"merchantId","required":true}],"responses":{"201":{"description":"Fiat settlement created. The merchant must complete KYB at `kybUrl` to activate routing.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Fiat settlement ID. Stable identifier — safe to persist on the partner side.","examples":["fiat_Bk4nWp8XmQj2YrTv6"]},"status":{"type":"string","description":"Fiat settlement status. `pending_kyb` immediately after creation — the merchant must complete KYB at `kybUrl` before payments can route to this account. Transitions to `active` on KYB approval; `rejected` if KYB fails.","examples":["pending_kyb"]},"kybUrl":{"description":"URL the merchant must visit to complete KYB verification. Returned at creation; treat as short-lived (hours to days). `null` only when no merchant action is pending.","examples":["https://kyb.iron.io/verify/abc123"],"type":["string","null"]}},"required":["id","status","kybUrl"]},"example":{"id":"fiat_Bk4nWp8XmQj2YrTv6","status":"pending_kyb","kybUrl":"https://kyb.iron.io/verify/abc123"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["params_validation","invalid_params","missing_idempotency_key"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"issues":{"description":"Field-level validation issues (present on validation errors)","type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"]}}},"required":["message","code"]},"examples":{"params_validation":{"summary":"Validation failed","value":{"code":"params_validation","message":"Validation failed"}},"invalid_params":{"summary":"Invalid request parameters","value":{"code":"invalid_params","message":"Invalid request parameters"}},"missing_idempotency_key":{"summary":"Missing Idempotency-Key header","value":{"code":"missing_idempotency_key","message":"Missing Idempotency-Key header"}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"code":"missing_api_key","message":"Missing API key"}},"invalid_api_key":{"summary":"Invalid API key","value":{"code":"invalid_api_key","message":"Invalid API key"}}}}}},"404":{"description":"Merchant not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"not_found","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"not_found":{"summary":"Not Found","value":{"code":"not_found","message":"Not Found"}}}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["idempotency_conflict","settlement_conflict"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"idempotency_conflict":{"summary":"Idempotency key conflict: same key was used with a different request body","value":{"code":"idempotency_conflict","message":"Idempotency key conflict: same key was used with a different request body"}},"settlement_conflict":{"summary":"A settlement with conflicting details already exists for this merchant","value":{"code":"settlement_conflict","message":"A settlement with conflicting details already exists for this merchant"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"internal_error","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"internal_error":{"summary":"Internal Server Error","value":{"code":"internal_error","message":"Internal Server Error"}}}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"bankDetails":{"oneOf":[{"type":"object","properties":{"accountHolderName":{"type":"string","minLength":1,"maxLength":255,"description":"Account holder name as it appears on the bank account. Usually matches the legal business name.","examples":["Acme Corp Inc"]},"bankName":{"type":"string","minLength":1,"maxLength":255,"description":"Display name of the bank that holds the account.","examples":["Chase"]},"bankCountry":{"description":"ISO 3166-1 alpha-2 country code of the bank.","type":"string","minLength":2,"maxLength":2},"bankType":{"type":"string","const":"SEPA","description":"Bank account type. `SEPA` settles in EUR via the SEPA network."},"iban":{"type":"string","minLength":15,"maxLength":34,"pattern":"^[A-Z]{2}[0-9]{2}[A-Z0-9]+$","description":"International Bank Account Number (ISO 13616). Uppercase alphanumeric with no spaces. Validated for format and mod-97 checksum.","examples":["FR1420041010050500013M02606"]}},"required":["accountHolderName","bankName","bankCountry","bankType","iban"],"description":"SEPA bank account details. Settles in EUR."},{"type":"object","properties":{"accountHolderName":{"type":"string","minLength":1,"maxLength":255,"description":"Account holder name as it appears on the bank account. Usually matches the legal business name.","examples":["Acme Corp Inc"]},"bankName":{"type":"string","minLength":1,"maxLength":255,"description":"Display name of the bank that holds the account.","examples":["Chase"]},"bankCountry":{"description":"ISO 3166-1 alpha-2 country code of the bank.","type":"string","minLength":2,"maxLength":2},"bankType":{"type":"string","const":"ACH","description":"Bank account type. `ACH` settles in USD via the US ACH network."},"accountNumber":{"type":"string","minLength":1,"pattern":"^[0-9A-Z]{4,17}$","description":"US bank account number. 4–17 uppercase letters or digits.","examples":["000123456789"]},"routingNumber":{"type":"string","minLength":1,"pattern":"^[0-9]{9}$","description":"9-digit ABA routing number identifying the US bank. Validated for ABA checksum.","examples":["021000021"]},"phoneNumber":{"type":"string","pattern":"^\\+1[2-9]\\d{2}[2-9]\\d{6}$","description":"Business phone number in E.164 format. Required by Iron for ACH onboarding compliance.","examples":["+14155551234"]}},"required":["accountHolderName","bankName","bankCountry","bankType","accountNumber","routingNumber","phoneNumber"],"description":"ACH bank account details. Settles in USD. Requires a US business address."}],"description":"Bank account that will receive fiat settlements. `bankType` discriminates the schema: SEPA requires `iban`; ACH requires `accountNumber`, `routingNumber`, and `phoneNumber`. Currency is implicit — SEPA settles in EUR, ACH in USD."},"businessDetails":{"type":"object","properties":{"businessName":{"type":"string","minLength":1,"maxLength":255,"description":"Legal name of the business that operates the merchant account.","examples":["Acme Corp Inc"]},"address":{"type":"object","properties":{"line1":{"type":"string","minLength":1,"maxLength":255,"description":"Street address line 1.","examples":["350 Fifth Avenue"]},"line2":{"description":"Optional second address line (suite, apartment, building, etc.). Empty strings are treated as omitted.","type":"string","maxLength":255},"city":{"type":"string","minLength":2,"maxLength":255,"description":"City or locality.","examples":["New York"]},"state":{"type":"string","minLength":1,"maxLength":255,"description":"State, province, or region. For ACH this must be a valid US state or territory 2-letter code (e.g. `NY`).","examples":["NY"]},"country":{"description":"ISO 3166-1 alpha-2 country code of the business address. Must be `US` when `bankType` is `ACH`.","type":"string","minLength":2,"maxLength":2},"zip":{"type":"string","minLength":1,"maxLength":20,"description":"Postal or ZIP code.","examples":["10118"]}},"required":["line1","city","state","country","zip"],"description":"Registered business address used for KYB verification."}},"required":["businessName","address"],"description":"Business identity details collected for KYB verification."}},"required":["bankDetails","businessDetails"]}}}},"servers":[{"url":"https://api.merchant.pay.walletconnect.com"}],"security":[{"apiKey":[]}]}},"/v1/merchants/{merchantId}/settlements/fiat/{id}":{"patch":{"operationId":"FiatSettlement_update","tags":["Fiat Settlement"],"summary":"Update a fiat settlement","description":"Partially update the bank or business details on an existing fiat settlement. At least one of `bankDetails` or `businessDetails` must be provided. Only cosmetic fields are mutable here — `iban`, `accountNumber`, and `routingNumber` cannot be changed in place; delete the settlement and re-create it to switch accounts. Iron's `customers.update` API only accepts `email` and `external_id`, so edits to the bank/business name, address, or account-holder name do not flow back to Iron and the merchant does not need to re-verify.","responses":{"200":{"description":"Settlement updated.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Fiat settlement ID that was updated.","examples":["fiat_Bk4nWp8XmQj2YrTv6"]}},"required":["id"]},"example":{"id":"fiat_Bk4nWp8XmQj2YrTv6"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["params_validation","invalid_params"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"issues":{"description":"Field-level validation issues (present on validation errors)","type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"]}}},"required":["message","code"]},"examples":{"params_validation":{"summary":"Validation failed","value":{"code":"params_validation","message":"Validation failed"}},"invalid_params":{"summary":"Invalid request parameters","value":{"code":"invalid_params","message":"Invalid request parameters"}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"code":"missing_api_key","message":"Missing API key"}},"invalid_api_key":{"summary":"Invalid API key","value":{"code":"invalid_api_key","message":"Invalid API key"}}}}}},"404":{"description":"Settlement not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"not_found","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"not_found":{"summary":"Not Found","value":{"code":"not_found","message":"Not Found"}}}}}},"409":{"description":"Settlement is managed through a partner KYB case attachment","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"settlement_conflict","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"settlement_conflict":{"summary":"A settlement with conflicting details already exists for this merchant","value":{"code":"settlement_conflict","message":"A settlement with conflicting details already exists for this merchant"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"internal_error","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"internal_error":{"summary":"Internal Server Error","value":{"code":"internal_error","message":"Internal Server Error"}}}}}}},"parameters":[{"in":"path","name":"id","schema":{"type":"string","minLength":1,"maxLength":256,"examples":["fiat_Bk4nWp8XmQj2YrTv6"]},"required":true,"description":"Fiat settlement ID returned at creation time."},{"schema":{"type":"string"},"in":"path","name":"merchantId","required":true}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"bankDetails":{"description":"Cosmetic bank-account updates. Account/routing numbers and IBAN cannot be changed in place — delete the settlement and re-create it to switch accounts.","type":"object","properties":{"accountHolderName":{"type":"string","minLength":1,"maxLength":255,"description":"Account holder name as it appears on the bank account. Usually matches the legal business name.","examples":["Acme Corp Inc"]},"bankName":{"type":"string","minLength":1,"maxLength":255,"description":"Display name of the bank that holds the account.","examples":["Chase"]},"bankCountry":{"description":"ISO 3166-1 alpha-2 country code of the bank.","type":"string","minLength":2,"maxLength":2}}},"businessDetails":{"description":"Business identity updates. Iron does not re-verify on cosmetic edits — KYB status is preserved.","type":"object","properties":{"businessName":{"description":"Legal name of the business.","examples":["Acme Corp Inc"],"type":"string","minLength":1,"maxLength":255},"address":{"description":"Subset of business address fields to update. Partial updates are merged with the existing record.","type":"object","properties":{"line1":{"type":"string","minLength":1,"maxLength":255,"description":"Street address line 1.","examples":["350 Fifth Avenue"]},"line2":{"description":"Optional second address line (suite, apartment, building, etc.). Empty strings are treated as omitted.","type":"string","maxLength":255},"city":{"type":"string","minLength":2,"maxLength":255,"description":"City or locality.","examples":["New York"]},"state":{"type":"string","minLength":1,"maxLength":255,"description":"State, province, or region. For ACH this must be a valid US state or territory 2-letter code (e.g. `NY`).","examples":["NY"]},"country":{"description":"ISO 3166-1 alpha-2 country code of the business address. Must be `US` when `bankType` is `ACH`.","type":"string","minLength":2,"maxLength":2},"zip":{"type":"string","minLength":1,"maxLength":20,"description":"Postal or ZIP code.","examples":["10118"]}}}}}}}}}},"servers":[{"url":"https://api.merchant.pay.walletconnect.com"}],"security":[{"apiKey":[]}]},"delete":{"operationId":"FiatSettlement_delete","tags":["Fiat Settlement"],"summary":"Delete a fiat settlement","description":"Soft-delete a fiat settlement route. Future payments will no longer auto-settle to this fiat account. MX notifies the Core API, which handles async deactivation of the underlying autoramps.","responses":{"200":{"description":"Settlement deleted.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Fiat settlement ID that was deleted.","examples":["fiat_Bk4nWp8XmQj2YrTv6"]},"deleted":{"type":"boolean","description":"Always `true` on success. Future payments will no longer route to this fiat account.","examples":[true]}},"required":["id","deleted"]},"example":{"id":"fiat_Bk4nWp8XmQj2YrTv6","deleted":true}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"invalid_params","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"invalid_params":{"summary":"Invalid request parameters","value":{"code":"invalid_params","message":"Invalid request parameters"}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"code":"missing_api_key","message":"Missing API key"}},"invalid_api_key":{"summary":"Invalid API key","value":{"code":"invalid_api_key","message":"Invalid API key"}}}}}},"404":{"description":"Settlement not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"not_found","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"not_found":{"summary":"Not Found","value":{"code":"not_found","message":"Not Found"}}}}}},"409":{"description":"Settlement is managed through a partner KYB case attachment","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"settlement_conflict","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"settlement_conflict":{"summary":"A settlement with conflicting details already exists for this merchant","value":{"code":"settlement_conflict","message":"A settlement with conflicting details already exists for this merchant"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","const":"internal_error","description":"Machine-readable error code"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["message","code"]},"examples":{"internal_error":{"summary":"Internal Server Error","value":{"code":"internal_error","message":"Internal Server Error"}}}}}}},"parameters":[{"in":"path","name":"id","schema":{"type":"string","minLength":1,"maxLength":256,"examples":["fiat_Bk4nWp8XmQj2YrTv6"]},"required":true,"description":"Fiat settlement ID returned at creation time."},{"schema":{"type":"string"},"in":"path","name":"merchantId","required":true}],"servers":[{"url":"https://api.merchant.pay.walletconnect.com"}],"security":[{"apiKey":[]}]}}},"tags":[{"name":"Gateway"},{"name":"Payments"},{"name":"Webhooks"},{"name":"Refunds"},{"name":"Sign"},{"name":"Merchant Management"},{"name":"Settlements"},{"name":"Crypto Settlement"},{"name":"Fiat Settlement"}],"components":{"schemas":{"Action":{"oneOf":[{"type":"object","description":"An action that requires a wallet RPC call to complete","required":["data","type"],"properties":{"data":{"$ref":"#/components/schemas/WalletRpcAction","description":"An action that requires a wallet RPC call to complete"},"type":{"type":"string","enum":["walletRpc"]}}},{"type":"object","description":"An action that requires building to complete","required":["data","type"],"properties":{"data":{"$ref":"#/components/schemas/Build","description":"An action that requires building to complete"},"type":{"type":"string","enum":["build"]}}},{"type":"object","description":"Send an amount to an account. The whole action, with no transaction to\nbuild or sign.","required":["data","type"],"properties":{"data":{"$ref":"#/components/schemas/TransferAction","description":"Send an amount to an account. The whole action, with no transaction to\nbuild or sign."},"type":{"type":"string","enum":["transfer"]}}}],"example":{"data":{"chain_id":"eip155:8453","method":"eth_signTypedData_v4","params":["0x0000000000000000000000000000000000000000","{\"domain\":{\"name\":\"USD Coin\",\"version\":\"2\",\"chainId\":\"0x2105\",\"verifyingContract\":\"0x0000000000000000000000000000000000000000\"},\"types\":{\"EIP712Domain\":[{\"type\":\"string\",\"name\":\"name\"},{\"type\":\"string\",\"name\":\"version\"},{\"type\":\"uint256\",\"name\":\"chainId\"},{\"type\":\"address\",\"name\":\"verifyingContract\"}],\"ReceiveWithAuthorization\":[{\"type\":\"address\",\"name\":\"from\"},{\"type\":\"address\",\"name\":\"to\"},{\"type\":\"uint256\",\"name\":\"value\"},{\"type\":\"uint256\",\"name\":\"validAfter\"},{\"type\":\"uint256\",\"name\":\"validBefore\"},{\"type\":\"bytes32\",\"name\":\"nonce\"}]},\"primaryType\":\"ReceiveWithAuthorization\",\"message\":{\"from\":\"0x0000000000000000000000000000000000000000\",\"nonce\":\"0x0000000000000000000000000000000000000000000000000000000000000000\",\"to\":\"0x0000000000000000000000000000000000000000\",\"validAfter\":\"0x0\",\"validBefore\":\"0x0\",\"value\":\"0x0\"}}"]},"type":"walletRpc"}},"Amount":{"type":"object","required":["unit","value","display"],"properties":{"display":{"$ref":"#/components/schemas/AmountDisplay","description":"Display information for the amount"},"unit":{"type":"string","description":"Currency unit, prefixed with either \"iso4217/\" or \"caip19/\"","example":"iso4217/USD"},"value":{"type":"string","description":"Amount value, in the currency unit's minor units"}},"example":{"display":{"assetName":"USD Coin","assetSymbol":"USDC","decimals":6,"iconUrl":"https://assets.walletconnect.com/usdc.png","networkIconUrl":"https://assets.walletconnect.com/base.png","networkName":"Base"},"unit":"caip19/eip155:8453/erc20:0x0000000000000000000000000000000000000000","value":"1000000"}},"AmountDisplay":{"type":"object","required":["assetSymbol","assetName","decimals"],"properties":{"assetName":{"type":"string","description":"Full name of the asset"},"assetSymbol":{"type":"string","description":"Ticker/symbol of the asset"},"decimals":{"type":"integer","format":"int32","description":"Number of minor decimals of the asset","minimum":0},"iconUrl":{"type":["string","null"],"description":"URL of the icon of the asset (if token)"},"networkIconUrl":{"type":["string","null"],"description":"URL of the icon of the network (if token)"},"networkName":{"type":["string","null"],"description":"Name of the network of the asset (if token)"}},"example":{"assetName":"USD Coin","assetSymbol":"USDC","decimals":6,"iconUrl":"https://assets.walletconnect.com/usdc.png","networkIconUrl":"https://assets.walletconnect.com/base.png","networkName":"Base"}},"AmountParameter":{"type":"object","required":["unit","value"],"properties":{"unit":{"type":"string","description":"Currency unit, prefixed with either \"iso4217/\" or \"caip19/\"","example":"iso4217/USD"},"value":{"type":"string","description":"Amount value, in the currency unit's minor units"}},"example":{"unit":"iso4217/USD","value":"100"}},"ApiErrorResponse":{"type":"object","description":"Standard `{ code, message }` error envelope shared across all API surfaces.","required":["code","message"],"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}}},"Build":{"type":"object","required":["data"],"properties":{"data":{"type":"string"}},"example":{"data":"..."}},"BuyerInfo":{"type":"object","required":["accountCaip10","accountProviderName"],"properties":{"accountCaip10":{"type":"string","description":"Account CAIP-10"},"accountProviderIcon":{"type":["string","null"],"description":"Account provider icon URL"},"accountProviderName":{"type":"string","description":"Account provider name"}},"example":{"accountCaip10":"eip155:1:0x0000000000000000000000000000000000000000","accountProviderIcon":"https://example.com/icon.png","accountProviderName":"Wallet"}},"CollectData":{"type":"object","required":["fields","schema","url"],"properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/CollectDataField"},"description":"Deprecated: Use `schema` and `url` fields instead for webview-based data collection","deprecated":true},"schema":{"description":"JSON Schema for validating IC form data (for webview mode)"},"url":{"type":"string","description":"URL for webview-based data collection"}},"example":{"fields":[{"id":"fullName","name":"Full name","required":true,"type":"text"},{"id":"dob","name":"Date of birth","required":true,"type":"date"}],"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"anyOf":[{"required":["pobCountry","pobAddress"]},{"required":["porCountry","porAddress"]}],"properties":{"dob":{"description":"Date of birth in YYYY-MM-DD format","format":"date","title":"Date of Birth","type":"string"},"fullName":{"description":"User's full legal name","minLength":1,"title":"Full Name","type":"string"},"pobAddress":{"description":"Place of birth city and state (e.g., 'New York, NY')","maxLength":200,"title":"Place of Birth Address","type":"string"},"pobCountry":{"description":"Place of birth country code (ISO 3166-1 alpha-2)","pattern":"^[A-Z]{2}$","title":"Place of Birth Country","type":"string"},"porAddress":{"description":"Place of residence street address, city, and state","maxLength":200,"title":"Place of Residence Address","type":"string"},"porCountry":{"description":"Place of residence country code (ISO 3166-1 alpha-2)","pattern":"^[A-Z]{2}$","title":"Place of Residence Country","type":"string"},"tosConfirmed":{"const":true,"description":"Must be true to confirm Terms of Service acceptance","title":"Terms of Service Confirmation","type":"boolean"}},"required":["fullName","dob","tosConfirmed"],"type":"object"},"url":"https://data-collection.walletconnect.com/ic/pay_123?accounts=eip155:1:0x123"}},"CollectDataField":{"type":"object","required":["type","id","name","required"],"properties":{"id":{"type":"string","description":"ID of the field for submission"},"name":{"type":"string","description":"Human readable name of the field"},"required":{"type":"boolean","description":"Requiredness of the field"},"type":{"$ref":"#/components/schemas/CollectDataFieldType","description":"Type of the field"}},"example":{"id":"fullName","name":"Full name","required":true,"type":"text"}},"CollectDataFieldType":{"type":"string","enum":["text","date","checkbox"]},"CollectedData":{"oneOf":[{"$ref":"#/components/schemas/StructuredIcInput"},{"$ref":"#/components/schemas/LegacyIcInput"}],"description":"Inline Information Capture accepted at `/fetch`, in either shape:\n\n- [`CollectedData::Structured`] — the typed [`StructuredIcInput`] schema, the format\n `/information-capture` uses and the one we are migrating to.\n- [`CollectedData::Legacy`] — the `/confirm` array form\n (`{ fields: [{ id, value }] }`), accepted during the transition.\n\nDisambiguated by serde: `StructuredIcInput` requires `fullName`/`dob`/`tosConfirmed`\nwhile the array form requires `fields`, so the shapes never overlap. Both\nnormalize to the same [`IcData`] before screening.\n\nBoth shapes carry personal data and must never be logged in the clear."},"ConfirmPaymentRequest":{"type":"object","required":["optionId","results"],"properties":{"collectedData":{"oneOf":[{"$ref":"#/components/schemas/CollectedData"},{"type":"null"}]},"optionId":{"type":"string","description":"ID of the option to confirm"},"results":{"type":"array","items":{"$ref":"#/components/schemas/ConfirmPaymentResult"}}},"example":{"collectedData":{"fields":[{"id":"fullName","value":"John Smith"},{"id":"dob","value":"1990-01-01"},{"id":"tosConfirmed","value":"true"},{"id":"pobCountry","value":"US"},{"id":"pobAddress","value":"New York, NY"}]},"excludeFromRelayer":null,"optionId":"opt_123","results":[{"data":["0x123"],"type":"walletRpc"}]}},"ConfirmPaymentResponse":{"type":"object","required":["status","isFinal"],"properties":{"info":{"oneOf":[{"$ref":"#/components/schemas/GatewayPaymentInformation","description":"Payment information (transaction hash). Present when status is\nSucceeded, null otherwise."},{"type":"null"}]},"isFinal":{"type":"boolean","description":"True if the payment is in a final state and no longer requires polling"},"pollInMs":{"type":["integer","null"],"format":"int64","description":"Time to poll for payment status, in milliseconds. Not present if the\npayment is in a final state.","minimum":0},"status":{"$ref":"#/components/schemas/PaymentStatus","description":"Payment status"}},"example":{"info":null,"isFinal":true,"pollInMs":null,"status":"succeeded"}},"ConfirmPaymentResult":{"oneOf":[{"type":"object","required":["data","type"],"properties":{"data":{"type":"array","items":{}},"type":{"type":"string","enum":["walletRpc"]}}}],"example":{"data":["0x123"],"type":"walletRpc"}},"CreatePayment":{"type":"object","required":["referenceId","amount"],"properties":{"amount":{"$ref":"#/components/schemas/AmountParameter"},"expiresAt":{"type":["integer","null"],"format":"int64"},"referenceId":{"type":"string"}},"example":{"amount":{"unit":"iso4217/USD","value":"100"},"expiresAt":null,"referenceId":"ORDER-123"}},"CreatePaymentResponse":{"type":"object","required":["paymentId","status","expiresAt","isFinal","gatewayUrl"],"properties":{"expiresAt":{"type":"integer","format":"int64","description":"Payment expiration timestamp, in seconds since epoch","minimum":0},"gatewayUrl":{"type":"string","description":"Gateway URL to redirect the user to for payment"},"isFinal":{"type":"boolean","description":"True if the payment is in a final state and no longer requires polling"},"paymentId":{"$ref":"#/components/schemas/PaymentId","description":"Payment ID"},"pollInMs":{"type":["integer","null"],"format":"int64","description":"Time to poll for payment status, in milliseconds. Not present if the\npayment is in a final state.","minimum":0},"status":{"$ref":"#/components/schemas/PaymentStatus","description":"Payment status"}},"example":{"expiresAt":1718236800,"gatewayUrl":"https://api.pay.walletconnect.com/pay_123","isFinal":false,"paymentId":"pay_53a2ecc101M61MCZJJG2RV91GZZP90GC2P","pollInMs":1000,"status":"requires_action"}},"ErrorCode":{"type":"string","description":"Standard error codes for API responses.\n\nThis prevents typos like \"invlaid_params\" from reaching production.","enum":["rate_limited","invalid_params","params_validation","payment_not_found","idempotency_conflict","internal_error","invalid_api_key","unauthorized","forbidden","invalid_state","payment_expired","over_spending_cap","amount_above_maximum","amount_below_minimum","quote_expired","missing_api_key","missing_merchant_api_key","missing_merchant_id","header_not_ascii","merchant_not_found","merchant_exists","api_key_not_found","partner_not_found","customer_not_found","wallet_not_found","executor_not_found","missing_app_id","missing_client_id","invalid_app_id","conflicting_auth_headers","missing_auth_headers","invalid_api_version","unknown_api_version","api_version_downgrade","sanctioned_user","payment_not_succeeded","already_refunded","not_test_payment","no_settlement_configuration","insufficient_wta_balance","not_found","method_not_allowed","not_implemented","orchestration_state_invalid","signature_mismatch","authorization_expired","sponsorship_cap_exceeded","attempts_spent","orchestration_in_progress"]},"FetchRequest":{"type":"object","required":["optionId","data"],"properties":{"collectedData":{"oneOf":[{"$ref":"#/components/schemas/CollectedData","description":"Optional inline Information Capture, supplied by native/Solana fetch-path\nclients to satisfy IC before the charge is signed. Accepts both the typed\nJSON schema and the legacy `/confirm` array form (see [`CollectedData`]).\nScreened and persisted as a pending record; a sanctions match fails the\npayment closed."},{"type":"null"}]},"data":{"type":"string","description":"Extra build payload"},"optionId":{"type":"string","description":"ID of the option to build an action for"}},"example":{"data":"...","optionId":"opt_123"}},"FetchResponse":{"type":"object","required":["actions"],"properties":{"actions":{"type":"array","items":{"$ref":"#/components/schemas/Action"},"description":"What the wallet has to do, never empty. Select an action by its type, not\nby its position: a push option returns a `transfer` alongside its\n`walletRpc` transaction on EVM, and on Solana returns the `transfer` alone,\nbecause a Solana transaction cannot be built without knowing the payer."}},"example":{"actions":[{"data":{"chain_id":"eip155:8453","method":"eth_signTypedData_v4","params":["0x0000000000000000000000000000000000000000","{\"domain\":{\"name\":\"USD Coin\",\"version\":\"2\",\"chainId\":\"0x2105\",\"verifyingContract\":\"0x0000000000000000000000000000000000000000\"},\"types\":{\"EIP712Domain\":[{\"type\":\"string\",\"name\":\"name\"},{\"type\":\"string\",\"name\":\"version\"},{\"type\":\"uint256\",\"name\":\"chainId\"},{\"type\":\"address\",\"name\":\"verifyingContract\"}],\"ReceiveWithAuthorization\":[{\"type\":\"address\",\"name\":\"from\"},{\"type\":\"address\",\"name\":\"to\"},{\"type\":\"uint256\",\"name\":\"value\"},{\"type\":\"uint256\",\"name\":\"validAfter\"},{\"type\":\"uint256\",\"name\":\"validBefore\"},{\"type\":\"bytes32\",\"name\":\"nonce\"}]},\"primaryType\":\"ReceiveWithAuthorization\",\"message\":{\"from\":\"0x0000000000000000000000000000000000000000\",\"nonce\":\"0x0000000000000000000000000000000000000000000000000000000000000000\",\"to\":\"0x0000000000000000000000000000000000000000\",\"validAfter\":\"0x0\",\"validBefore\":\"0x0\",\"value\":\"0x0\"}}"]},"type":"walletRpc"}]}},"GatewayCancelPaymentResponse":{"type":"object","required":["paymentId","status","cancelledReason","cancelledAt"],"properties":{"cancelledAt":{"type":"string"},"cancelledReason":{"type":"string"},"paymentId":{"$ref":"#/components/schemas/PaymentId"},"status":{"$ref":"#/components/schemas/PaymentStatus"}},"example":{"cancelledAt":"2025-01-14T10:30:00Z","cancelledReason":"cancelled_by_user","paymentId":"pay_5ba2ecc101M61MCZJMWE7Y0MPKH1YQSVVF","status":"cancelled"}},"GatewayPaymentInformation":{"type":"object","description":"Payment information returned when a gateway payment succeeds.","required":["txId","optionAmount"],"properties":{"optionAmount":{"$ref":"#/components/schemas/Amount","description":"Amount paid in token units"},"txId":{"type":"string","description":"Transaction identifier (hash)"}}},"GatewayTransitionRequest":{"oneOf":[{"type":"object","required":["option_id","buyer_caip10","status"],"properties":{"buyer_caip10":{"type":"string"},"option_id":{"type":"string"},"status":{"type":"string","enum":["processing"]}}},{"type":"object","required":["tx_id","status"],"properties":{"status":{"type":"string","enum":["succeeded"]},"tx_id":{"$ref":"#/components/schemas/TxId"}}},{"type":"object","required":["tx_id","status"],"properties":{"status":{"type":"string","enum":["settled"]},"tx_id":{"$ref":"#/components/schemas/TxId"}}},{"type":"object","required":["failure_reason","status"],"properties":{"failure_reason":{"type":"string"},"status":{"type":"string","enum":["failed"]}}},{"type":"object","required":["status"],"properties":{"status":{"type":"string","enum":["expired"]}}},{"type":"object","required":["cancellation_reason","status"],"properties":{"cancellation_reason":{"type":"string"},"status":{"type":"string","enum":["cancelled"]}}}],"description":"Gateway sibling of [`TestTransitionRequest`]. Identical except the\n`processing` transition takes no `wallet_id`: the gateway is\nwallet-authenticated, so the wallet is derived from the request's\ncredentials rather than supplied in the body."},"GetPaymentOptionsRequest":{"type":"object","required":["accounts"],"properties":{"accounts":{"type":"array","items":{"type":"string"},"example":["eip155:1:0x0000000000000000000000000000000000000000"]},"refresh":{"type":["array","null"],"items":{"type":"string"}}},"example":{"accounts":["eip155:1:0x0000000000000000000000000000000000000000"],"refresh":null}},"GetPaymentOptionsResponse":{"type":"object","properties":{"collectData":{"oneOf":[{"$ref":"#/components/schemas/CollectData"},{"type":"null"}]},"info":{"oneOf":[{"$ref":"#/components/schemas/GetPaymentResponse"},{"type":"null"}]},"options":{"type":["array","null"],"items":{"$ref":"#/components/schemas/PaymentOption"}}},"example":{"collectData":{"fields":[{"id":"fullName","name":"Full name","required":true,"type":"text"},{"id":"dob","name":"Date of birth","required":true,"type":"date"}],"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"anyOf":[{"required":["pobCountry","pobAddress"]},{"required":["porCountry","porAddress"]}],"properties":{"dob":{"description":"Date of birth in YYYY-MM-DD format","format":"date","title":"Date of Birth","type":"string"},"fullName":{"description":"User's full legal name","minLength":1,"title":"Full Name","type":"string"},"pobAddress":{"description":"Place of birth city and state (e.g., 'New York, NY')","maxLength":200,"title":"Place of Birth Address","type":"string"},"pobCountry":{"description":"Place of birth country code (ISO 3166-1 alpha-2)","pattern":"^[A-Z]{2}$","title":"Place of Birth Country","type":"string"},"porAddress":{"description":"Place of residence street address, city, and state","maxLength":200,"title":"Place of Residence Address","type":"string"},"porCountry":{"description":"Place of residence country code (ISO 3166-1 alpha-2)","pattern":"^[A-Z]{2}$","title":"Place of Residence Country","type":"string"},"tosConfirmed":{"const":true,"description":"Must be true to confirm Terms of Service acceptance","title":"Terms of Service Confirmation","type":"boolean"}},"required":["fullName","dob","tosConfirmed"],"type":"object"},"url":"https://data-collection.walletconnect.com/ic/pay_123?accounts=eip155:1:0x123"},"info":{"amount":{"display":{"assetName":"USD Coin","assetSymbol":"USDC","decimals":6,"iconUrl":"https://assets.walletconnect.com/usdc.png","networkIconUrl":"https://assets.walletconnect.com/base.png","networkName":"Base"},"unit":"caip19/eip155:8453/erc20:0x0000000000000000000000000000000000000000","value":"1000000"},"buyer":{"accountCaip10":"eip155:1:0x0000000000000000000000000000000000000000","accountProviderIcon":"https://example.com/icon.png","accountProviderName":"Wallet"},"expiresAt":1700000000,"merchant":{"iconUrl":"https://example.com/icon.png","name":"Merchant"},"status":"requires_action"},"options":[{"account":"eip155:1:0x0000000000000000000000000000000000000000","actions":[{"data":{"chain_id":"eip155:8453","method":"eth_signTypedData_v4","params":["0x0000000000000000000000000000000000000000","{\"domain\":{\"name\":\"USD Coin\",\"version\":\"2\",\"chainId\":\"0x2105\",\"verifyingContract\":\"0x0000000000000000000000000000000000000000\"},\"types\":{\"EIP712Domain\":[{\"type\":\"string\",\"name\":\"name\"},{\"type\":\"string\",\"name\":\"version\"},{\"type\":\"uint256\",\"name\":\"chainId\"},{\"type\":\"address\",\"name\":\"verifyingContract\"}],\"ReceiveWithAuthorization\":[{\"type\":\"address\",\"name\":\"from\"},{\"type\":\"address\",\"name\":\"to\"},{\"type\":\"uint256\",\"name\":\"value\"},{\"type\":\"uint256\",\"name\":\"validAfter\"},{\"type\":\"uint256\",\"name\":\"validBefore\"},{\"type\":\"bytes32\",\"name\":\"nonce\"}]},\"primaryType\":\"ReceiveWithAuthorization\",\"message\":{\"from\":\"0x0000000000000000000000000000000000000000\",\"nonce\":\"0x0000000000000000000000000000000000000000000000000000000000000000\",\"to\":\"0x0000000000000000000000000000000000000000\",\"validAfter\":\"0x0\",\"validBefore\":\"0x0\",\"value\":\"0x0\"}}"]},"type":"walletRpc"}],"amount":{"display":{"assetName":"USD Coin","assetSymbol":"USDC","decimals":6,"iconUrl":"https://assets.walletconnect.com/usdc.png","networkIconUrl":"https://assets.walletconnect.com/base.png","networkName":"Base"},"unit":"caip19/eip155:8453/erc20:0x0000000000000000000000000000000000000000","value":"1000000"},"collectData":{"fields":[{"id":"fullName","name":"Full name","required":true,"type":"text"},{"id":"dob","name":"Date of birth","required":true,"type":"date"}],"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"anyOf":[{"required":["pobCountry","pobAddress"]},{"required":["porCountry","porAddress"]}],"properties":{"dob":{"description":"Date of birth in YYYY-MM-DD format","format":"date","title":"Date of Birth","type":"string"},"fullName":{"description":"User's full legal name","minLength":1,"title":"Full Name","type":"string"},"pobAddress":{"description":"Place of birth city and state (e.g., 'New York, NY')","maxLength":200,"title":"Place of Birth Address","type":"string"},"pobCountry":{"description":"Place of birth country code (ISO 3166-1 alpha-2)","pattern":"^[A-Z]{2}$","title":"Place of Birth Country","type":"string"},"porAddress":{"description":"Place of residence street address, city, and state","maxLength":200,"title":"Place of Residence Address","type":"string"},"porCountry":{"description":"Place of residence country code (ISO 3166-1 alpha-2)","pattern":"^[A-Z]{2}$","title":"Place of Residence Country","type":"string"},"tosConfirmed":{"const":true,"description":"Must be true to confirm Terms of Service acceptance","title":"Terms of Service Confirmation","type":"boolean"}},"required":["fullName","dob","tosConfirmed"],"type":"object"},"url":"https://data-collection.walletconnect.com/ic/pay_123?accounts=eip155:1:0x123"},"etaS":5,"expiresAt":1700000300,"id":"opt_123"}]}},"GetPaymentResponse":{"type":"object","required":["status","amount","expiresAt","merchant"],"properties":{"amount":{"$ref":"#/components/schemas/Amount"},"buyer":{"oneOf":[{"$ref":"#/components/schemas/BuyerInfo"},{"type":"null"}]},"expiresAt":{"type":"integer","format":"int64","minimum":0},"merchant":{"$ref":"#/components/schemas/MerchantInfo"},"status":{"$ref":"#/components/schemas/PaymentStatus"}},"example":{"amount":{"display":{"assetName":"USD Coin","assetSymbol":"USDC","decimals":6,"iconUrl":"https://assets.walletconnect.com/usdc.png","networkIconUrl":"https://assets.walletconnect.com/base.png","networkName":"Base"},"unit":"caip19/eip155:8453/erc20:0x0000000000000000000000000000000000000000","value":"1000000"},"buyer":{"accountCaip10":"eip155:1:0x0000000000000000000000000000000000000000","accountProviderIcon":"https://example.com/icon.png","accountProviderName":"Wallet"},"expiresAt":1700000000,"merchant":{"iconUrl":"https://example.com/icon.png","name":"Merchant"},"status":"requires_action"}},"GetPaymentStatusResponse":{"type":"object","required":["status","isFinal"],"properties":{"failureCode":{"oneOf":[{"$ref":"#/components/schemas/PaymentFailureCode","description":"Machine-readable reason identifying why the payment failed. Present\nonly when `status == \"failed\"`."},{"type":"null"}]},"info":{"oneOf":[{"$ref":"#/components/schemas/PaymentInformation","description":"Payment information (transaction hash, amount). Present when status is\nSucceeded, null otherwise."},{"type":"null"}]},"isFinal":{"type":"boolean","description":"True if the payment is in a final state and no longer requires polling"},"pollInMs":{"type":["integer","null"],"format":"int64","description":"Time to poll for payment status, in milliseconds. Not present if the\npayment is in a final state.","minimum":0},"status":{"$ref":"#/components/schemas/PaymentStatus","description":"Payment status"}},"example":{"info":{"optionAmount":{"display":{"assetName":"USD Coin","assetSymbol":"USDC","decimals":6,"iconUrl":"https://assets.walletconnect.com/usdc.png","networkIconUrl":"https://assets.walletconnect.com/base.png","networkName":"Base"},"unit":"caip19/eip155:8453/erc20:0x0000000000000000000000000000000000000000","value":"1000000"},"txId":"0xabc123..."},"isFinal":true,"pollInMs":null,"status":"succeeded"}},"LegacyIcInput":{"type":"object","description":"Legacy Information Capture wire shape: a flat `{ fields: [{ id, value }] }`\narray submitted on the gateway `/confirm` (and accepted at `/fetch`) request\nbody. Normalized into [`IcData`] by\n[`super::parse::parse_legacy`] before screening/persistence.","required":["fields"],"properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/LegacyIcInputField"}}},"example":{"fields":[{"id":"fullName","value":"John Smith"},{"id":"dob","value":"1990-01-01"},{"id":"tosConfirmed","value":"true"},{"id":"pobCountry","value":"US"},{"id":"pobAddress","value":"New York, NY"}]}},"LegacyIcInputField":{"type":"object","required":["id","value"],"properties":{"id":{"type":"string"},"value":{"type":"string"}},"example":{"id":"fullName","value":"John"}},"MerchantInfo":{"type":"object","required":["name"],"properties":{"iconUrl":{"type":["string","null"],"description":"Merchant icon URL"},"name":{"type":"string","description":"Merchant name"}},"example":{"iconUrl":"https://example.com/icon.png","name":"Merchant"}},"PaymentFailureCode":{"type":"string","description":"Machine-readable code identifying why a payment reached `Failed`.\n\nTwo distinct string forms exist per variant:\n- **Strum** (`Display`/`AsRefStr`/`EnumString`): the DynamoDB storage form\n written to the `failure_reason` column. Preserves the existing on-disk\n value for rows written before this type existed.\n- **Serde** (`Serialize`/`Deserialize`): the public API form. Deliberately\n decoupled from the internal term so that compliance-specific wording\n isn't surfaced to external consumers.","enum":["declined_user","internal_error","authorization_expired","broadcast_failed"]},"PaymentId":{"type":"string","description":"Payment ID","examples":["pay_7fa2ecc101ARZ3NDEKTSV4RRFFQ69G5FAV"]},"PaymentInformation":{"type":"object","description":"Payment information returned when payment succeeds","required":["txId","optionAmount"],"properties":{"optionAmount":{"$ref":"#/components/schemas/Amount","description":"Amount paid in token units"},"txId":{"type":"string","description":"Transaction identifier (hash)"}},"example":{"optionAmount":{"display":{"assetName":"USD Coin","assetSymbol":"USDC","decimals":6,"iconUrl":"https://assets.walletconnect.com/usdc.png","networkIconUrl":"https://assets.walletconnect.com/base.png","networkName":"Base"},"unit":"caip19/eip155:8453/erc20:0x0000000000000000000000000000000000000000","value":"1000000"},"txId":"0xabc123..."}},"PaymentOption":{"type":"object","required":["id","account","amount","etaS","actions"],"properties":{"account":{"type":"string","description":"The account to use for the option"},"actions":{"type":"array","items":{"$ref":"#/components/schemas/Action"},"description":"Actions required to complete the option"},"amount":{"$ref":"#/components/schemas/Amount","description":"The option's token and amount"},"collectData":{"oneOf":[{"$ref":"#/components/schemas/CollectData","description":"Per-option IC data collection info. Present when this option's account requires data collection, null otherwise."},{"type":"null"}]},"etaS":{"type":"integer","format":"int64","description":"Estimated time to complete the option, in seconds","minimum":0},"expiresAt":{"type":["integer","null"],"format":"int64","description":"Unix timestamp (seconds) after which this quote is stale and confirm_payment\nwill reject it with `quote_expired`. The wallet should re-fetch options before\nthis deadline. `None` for direct-currency options that don't involve a rate.","minimum":0},"id":{"type":"string","description":"ID of the option to be used to refer to it in other requests. May be up to 2^16 characters."}},"example":{"account":"eip155:1:0x0000000000000000000000000000000000000000","actions":[{"data":{"chain_id":"eip155:8453","method":"eth_signTypedData_v4","params":["0x0000000000000000000000000000000000000000","{\"domain\":{\"name\":\"USD Coin\",\"version\":\"2\",\"chainId\":\"0x2105\",\"verifyingContract\":\"0x0000000000000000000000000000000000000000\"},\"types\":{\"EIP712Domain\":[{\"type\":\"string\",\"name\":\"name\"},{\"type\":\"string\",\"name\":\"version\"},{\"type\":\"uint256\",\"name\":\"chainId\"},{\"type\":\"address\",\"name\":\"verifyingContract\"}],\"ReceiveWithAuthorization\":[{\"type\":\"address\",\"name\":\"from\"},{\"type\":\"address\",\"name\":\"to\"},{\"type\":\"uint256\",\"name\":\"value\"},{\"type\":\"uint256\",\"name\":\"validAfter\"},{\"type\":\"uint256\",\"name\":\"validBefore\"},{\"type\":\"bytes32\",\"name\":\"nonce\"}]},\"primaryType\":\"ReceiveWithAuthorization\",\"message\":{\"from\":\"0x0000000000000000000000000000000000000000\",\"nonce\":\"0x0000000000000000000000000000000000000000000000000000000000000000\",\"to\":\"0x0000000000000000000000000000000000000000\",\"validAfter\":\"0x0\",\"validBefore\":\"0x0\",\"value\":\"0x0\"}}"]},"type":"walletRpc"}],"amount":{"display":{"assetName":"USD Coin","assetSymbol":"USDC","decimals":6,"iconUrl":"https://assets.walletconnect.com/usdc.png","networkIconUrl":"https://assets.walletconnect.com/base.png","networkName":"Base"},"unit":"caip19/eip155:8453/erc20:0x0000000000000000000000000000000000000000","value":"1000000"},"collectData":{"fields":[{"id":"fullName","name":"Full name","required":true,"type":"text"},{"id":"dob","name":"Date of birth","required":true,"type":"date"}],"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"anyOf":[{"required":["pobCountry","pobAddress"]},{"required":["porCountry","porAddress"]}],"properties":{"dob":{"description":"Date of birth in YYYY-MM-DD format","format":"date","title":"Date of Birth","type":"string"},"fullName":{"description":"User's full legal name","minLength":1,"title":"Full Name","type":"string"},"pobAddress":{"description":"Place of birth city and state (e.g., 'New York, NY')","maxLength":200,"title":"Place of Birth Address","type":"string"},"pobCountry":{"description":"Place of birth country code (ISO 3166-1 alpha-2)","pattern":"^[A-Z]{2}$","title":"Place of Birth Country","type":"string"},"porAddress":{"description":"Place of residence street address, city, and state","maxLength":200,"title":"Place of Residence Address","type":"string"},"porCountry":{"description":"Place of residence country code (ISO 3166-1 alpha-2)","pattern":"^[A-Z]{2}$","title":"Place of Residence Country","type":"string"},"tosConfirmed":{"const":true,"description":"Must be true to confirm Terms of Service acceptance","title":"Terms of Service Confirmation","type":"boolean"}},"required":["fullName","dob","tosConfirmed"],"type":"object"},"url":"https://data-collection.walletconnect.com/ic/pay_123?accounts=eip155:1:0x123"},"etaS":5,"expiresAt":1700000300,"id":"opt_123"}},"PaymentStatus":{"type":"string","description":"Payment status representing the lifecycle of a payment.\n\nPayments progress through these states from creation to terminal status.\nSome states are specific to the payment source (pull vs push).","enum":["requires_action","processing","succeeded","failed","expired","cancelled"]},"PaymentsCancelPaymentResponse":{"type":"object","required":["paymentId","status","cancelledReason","cancelledAt"],"properties":{"cancelledAt":{"type":"string"},"cancelledReason":{"type":"string"},"paymentId":{"$ref":"#/components/schemas/PaymentId"},"status":{"$ref":"#/components/schemas/PaymentStatus"}},"example":{"cancelledAt":"2025-01-14T10:30:00Z","cancelledReason":"cancelled_by_merchant","paymentId":"pay_54a2ecc101M61MCZJJ511CG33T2R21R1JB","status":"cancelled"}},"PaymentsGetPaymentResponse":{"type":"object","required":["status","referenceId"],"properties":{"failureCode":{"oneOf":[{"$ref":"#/components/schemas/PaymentFailureCode","description":"Machine-readable reason identifying why the payment failed. Present\nonly when `status == \"failed\"`."},{"type":"null"}]},"info":{"oneOf":[{"$ref":"#/components/schemas/PaymentInformation","description":"Payment information (transaction hash, amount). Present when status is\nSucceeded, null otherwise."},{"type":"null"}]},"referenceId":{"type":"string","description":"Merchant-provided reference ID for this payment, as supplied during\npayment creation"},"settlement":{"oneOf":[{"$ref":"#/components/schemas/PaymentsSettlementInformation","description":"Settlement metadata for the MTA → destination transfer. Null when\nsettlement has not completed yet (pending, non-MTA flows, or\npre-confirmation)."},{"type":"null"}]},"status":{"$ref":"#/components/schemas/PaymentStatus","description":"Payment status"}},"example":{"info":{"optionAmount":{"display":{"assetName":"USD Coin","assetSymbol":"USDC","decimals":6,"iconUrl":"https://assets.walletconnect.com/usdc.png","networkIconUrl":"https://assets.walletconnect.com/base.png","networkName":"Base"},"unit":"caip19/eip155:8453/erc20:0x0000000000000000000000000000000000000000","value":"1000000"},"txId":"0xabc123..."},"referenceId":"ORDER-123","settlement":null,"status":"succeeded"}},"PaymentsSettlementInformation":{"type":"object","description":"Settlement metadata returned for MTA-based payments.\n\nOnly present once the settlement transfer has completed on-chain.","properties":{"successful":{"oneOf":[{"$ref":"#/components/schemas/PaymentsSettlementSuccessful","description":"Settlement success details. Null while settlement is pending,\npopulated once the on-chain transfer completes successfully."},{"type":"null"}]}},"example":{"successful":{"amount":{"unit":"caip19/eip155:1/erc20:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","value":"1000000"},"txId":"0xabc123def456789abc123def456789abc123def456789abc123def456789abc1"}}},"PaymentsSettlementSuccessful":{"type":"object","description":"Details of a successful settlement transfer.","required":["amount"],"properties":{"amount":{"$ref":"#/components/schemas/AmountParameter","description":"The settled amount — the asset/currency and value transferred. Read from\nthe confirmed on-chain transfer, falling back to the committed option\namount for test/APM settlements that move no on-chain funds."},"txId":{"type":["string","null"],"description":"Transaction hash of the MTA → settlement destination transfer. Optional\nto leave room for future settlement shapes that may not carry one."}},"example":{"amount":{"unit":"caip19/eip155:1/erc20:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","value":"1000000"},"txId":"0xabc123def456789abc123def456789abc123def456789abc123def456789abc1"}},"SettlementOverride":{"type":"object","description":"Per-payment settlement override. Stored on the payment and used in both\nthe merchant API request and the DB; overrides always route through the\nMTA, so unlike [`SettlementOption`] there is no `mta` flag to configure.","required":["options"],"properties":{"options":{"type":"array","items":{"$ref":"#/components/schemas/SettlementOverrideOption"}}}},"SettlementOverrideOption":{"oneOf":[{"type":"object","required":["asset","destination","kind"],"properties":{"asset":{"type":"string","description":"CAIP-19 asset identifier","example":"eip155:1/erc20:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},"destination":{"type":"string","description":"CAIP-10 destination address","example":"eip155:1:0x0000000000000000000000000000000000000000"},"kind":{"type":"string","enum":["crypto"]}}}],"example":{"asset":"eip155:1/erc20:0x0000000000000000000000000000000000000000","destination":"eip155:1:0x0000000000000000000000000000000000000000","kind":"crypto"}},"StructuredIcInput":{"type":"object","description":"Typed Information Capture data — the JSON-schema shape used by\n`/information-capture` and the format `/fetch` is migrating to.\n\nCarries personal data (full name, date of birth, place of birth/residence), so\nit must never be logged in the clear.","required":["fullName","dob","tosConfirmed"],"properties":{"dob":{"type":"string","description":"Date of birth in YYYY-MM-DD format"},"fullName":{"type":"string","description":"User's full legal name"},"pobAddress":{"type":["string","null"],"description":"Place of birth address. None when PoR-only"},"pobCountry":{"type":["string","null"],"description":"Place of birth country (ISO 3166-1 alpha-2 code). None when PoR-only"},"porAddress":{"type":["string","null"],"description":"Place of residence address. None when PoB-only"},"porCountry":{"type":["string","null"],"description":"Place of residence country (ISO 3166-1 alpha-2 code). None when PoB-only"},"tosConfirmed":{"type":"boolean","description":"Whether the user accepted the Terms of Service"}},"example":{"dob":"1990-05-15","fullName":"John Doe","pobAddress":"New York, NY","pobCountry":"US","porAddress":null,"porCountry":null,"tosConfirmed":true}},"TestTransitionRequest":{"oneOf":[{"type":"object","description":"Commit the payment to `processing`. The `option_id` selects a\nserver-stored option; method and chain are derived from it. No\nsignature, hash, or relayer enqueue — test processing does no\non-chain work.","required":["option_id","wallet_id","buyer_caip10","status"],"properties":{"buyer_caip10":{"type":"string"},"option_id":{"type":"string"},"status":{"type":"string","enum":["processing"]},"wallet_id":{"type":"string"}}},{"type":"object","description":"Mark the payment `succeeded`. Does not settle — settling is a separate\n`settled` request. `tx_id` is the required, typed payment transaction,\nrecorded like any mined tx so downstream read surfaces (status, confirm)\ncan return it.","required":["tx_id","status"],"properties":{"status":{"type":"string","enum":["succeeded"]},"tx_id":{"$ref":"#/components/schemas/TxId"}}},{"type":"object","description":"Mark the payment's settlement `successful` (sub-state of `succeeded`).\nNot a [`PaymentStatus`]; the payment stays `succeeded`. `tx_id` is the\nsettlement transaction, required — the caller must supply one.","required":["tx_id","status"],"properties":{"status":{"type":"string","enum":["settled"]},"tx_id":{"$ref":"#/components/schemas/TxId"}}},{"type":"object","required":["failure_reason","status"],"properties":{"failure_reason":{"type":"string"},"status":{"type":"string","enum":["failed"]}}},{"type":"object","required":["status"],"properties":{"status":{"type":"string","enum":["expired"]}}},{"type":"object","required":["cancellation_reason","status"],"properties":{"cancellation_reason":{"type":"string"},"status":{"type":"string","enum":["cancelled"]}}}],"description":"Target state for a test transition. Tagged by `status`; callers supply\nonly caller-specific data — everything derivable (option data, payment\nmethod, chain) is computed server-side from the committed payment."},"TestTransitionResponse":{"type":"object","title":"TestTransitionResponse","required":["paymentId","status"],"properties":{"paymentId":{"$ref":"#/components/schemas/PaymentId"},"status":{"$ref":"#/components/schemas/PaymentStatus"}}},"TransferAction":{"type":"object","description":"\"Send this much of this token to this account\" — the complete instruction, in\nCAIP terms, with nothing to decode.\n\nThe other two actions describe a *transaction*: `walletRpc` names an RPC\nmethod and its params, `build` carries an opaque payload to build from.\nBoth require the client to understand the chain it is on. A push payment needs\nneither: the buyer sends a plain transfer from any wallet, and the only\ninformation they need is the destination and the amount. Expressing that as\ncalldata would force every client to parse an ERC-20 `transfer` (and a\ndifferent encoding per chain family) just to display where the money is going.\n\nOnly returned for a push option, and only from `/fetch` — an option is never\nquoted with one, because the destination does not exist until `/fetch` derives\nit. It may be the only action returned: a Solana push option has no\ntransaction to sign.","required":["to","amount"],"properties":{"amount":{"$ref":"#/components/schemas/Amount","description":"What to send — the option's token and amount, repeated here so the action\nis self-contained and can be rendered without cross-referencing the option\nit came from."},"to":{"type":"string","description":"The account to send to (CAIP-10), derived for this payment.","example":"eip155:8453:0x0000000000000000000000000000000000000000"}},"example":{"amount":{"display":{"assetName":"USD Coin","assetSymbol":"USDC","decimals":6,"iconUrl":"https://assets.walletconnect.com/usdc.png","networkIconUrl":"https://assets.walletconnect.com/base.png","networkName":"Base"},"unit":"caip19/eip155:8453/erc20:0x0000000000000000000000000000000000000000","value":"1000000"},"to":"eip155:8453:0x0000000000000000000000000000000000000000"}},"TxId":{"oneOf":[{"type":"object","required":["data","namespace"],"properties":{"data":{"type":"object","required":["tx_hash"],"properties":{"tx_hash":{"type":"string"}}},"namespace":{"type":"string","enum":["eip155"]}}},{"type":"object","required":["data","namespace"],"properties":{"data":{"type":"object","required":["signature"],"properties":{"signature":{"type":"string"}}},"namespace":{"type":"string","enum":["solana"]}}},{"type":"object","required":["data","namespace"],"properties":{"data":{"type":"object","required":["tx_hash"],"properties":{"tx_hash":{"type":"string","description":"The canonical (fee-bump) hash, hex."}}},"namespace":{"type":"string","enum":["stellar"]}}},{"type":"object","required":["data","namespace"],"properties":{"data":{"type":"object","required":["tx_hash"],"properties":{"tx_hash":{"type":"string","description":"The canonical txID (`sha256(raw_data)`), hex."}}},"namespace":{"type":"string","enum":["tron"]}}}],"description":"Chain-agnostic confirmed-transaction identifier. Used only as the lifted id on\n`CryptoTransferActionState::Confirmed` and in API responses — never an\nin-flight state."},"WalletRpcAction":{"type":"object","required":["chain_id","method","params"],"properties":{"chain_id":{"type":"string"},"method":{"type":"string"},"params":{"type":"array","items":{}}},"example":{"chain_id":"eip155:8453","method":"eth_signTypedData_v4","params":["0x0000000000000000000000000000000000000000","{\"domain\":{\"name\":\"USD Coin\",\"version\":\"2\",\"chainId\":\"0x2105\",\"verifyingContract\":\"0x0000000000000000000000000000000000000000\"},\"types\":{\"EIP712Domain\":[{\"type\":\"string\",\"name\":\"name\"},{\"type\":\"string\",\"name\":\"version\"},{\"type\":\"uint256\",\"name\":\"chainId\"},{\"type\":\"address\",\"name\":\"verifyingContract\"}],\"ReceiveWithAuthorization\":[{\"type\":\"address\",\"name\":\"from\"},{\"type\":\"address\",\"name\":\"to\"},{\"type\":\"uint256\",\"name\":\"value\"},{\"type\":\"uint256\",\"name\":\"validAfter\"},{\"type\":\"uint256\",\"name\":\"validBefore\"},{\"type\":\"bytes32\",\"name\":\"nonce\"}]},\"primaryType\":\"ReceiveWithAuthorization\",\"message\":{\"from\":\"0x0000000000000000000000000000000000000000\",\"nonce\":\"0x0000000000000000000000000000000000000000000000000000000000000000\",\"to\":\"0x0000000000000000000000000000000000000000\",\"validAfter\":\"0x0\",\"validBefore\":\"0x0\",\"value\":\"0x0\"}}"]}},"MerchantApiErrorCode":{"type":"string","enum":["invalid_params","params_validation","not_found","internal_error","bad_gateway","rate_limited","payment_transition_conflict","payment_transition_unavailable","settlement_asset_conflict","settlement_conflict","settlement_destination_not_ready","token_not_enabled","version_conflict","payouts_unavailable","logo_too_small","logo_too_large","logo_not_square","logo_file_too_big","logo_invalid_mime","logo_invalid_dimensions","missing_api_key","invalid_api_key","missing_merchant_id","invalid_api_version","unknown_api_version","api_version_downgrade","idempotency_conflict","missing_idempotency_key","payment_not_succeeded","already_refunded","receipt_unavailable","receipt_service_unavailable","payouts_disabled","unsupported_asset","payout_account_unavailable","payout_account_busy","screening_unavailable"],"description":"Machine-readable error code"},"MerchantApiErrorResponse":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string","description":"Human-readable error message"},"code":{"$ref":"#/components/schemas/MerchantApiErrorCode"},"issues":{"type":"array","description":"Field-level validation issues (present on validation errors)","items":{"type":"object","required":["field","message"],"properties":{"field":{"type":"string"},"message":{"type":"string"}}}}}},"MerchantPaymentFiatAmount":{"type":"object","properties":{"unit":{"type":"string","pattern":"^iso4217\\/","description":"Fiat unit, for example \"iso4217/USD\""},"value":{"type":"string","description":"Amount in minor units for the fiat currency"},"display":{"type":"object","properties":{"assetSymbol":{"type":"string"},"assetName":{"type":"string"},"decimals":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["assetSymbol","assetName","decimals"],"description":"Display metadata for fiat-denominated amounts"}},"required":["unit","value","display"],"description":"Fiat-denominated amount"},"MerchantPaymentTokenAmount":{"type":"object","properties":{"unit":{"type":"string","pattern":"^caip19\\/","description":"Token unit, for example \"caip19/...\""},"value":{"type":"string","description":"Amount in minor units for the token asset"},"display":{"anyOf":[{"type":"object","properties":{"assetSymbol":{"type":"string"},"assetName":{"type":"string"},"decimals":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"iconUrl":{"type":"string"},"networkName":{"type":"string"},"networkIconUrl":{"type":"string"}},"required":["assetSymbol","assetName","decimals"],"description":"Display metadata for token-denominated amounts"},{"type":"null"}]}},"required":["unit","value","display"],"description":"Token-denominated amount"},"MerchantPaymentSettlement":{"description":"Settlement details. Omitted when settlement details cannot be reported yet. When present, `settled` is always included. When `settled` is `false`, no additional settlement fields are returned. When `settled` is `true`, `amount` is included and `txHash` is included when available.","type":"object","properties":{"settled":{"type":"boolean","description":"Whether settlement is complete."},"amount":{"description":"Net settlement amount after fees in the settlement unit. Present when `settled` is `true`.","anyOf":[{"$ref":"#/components/schemas/MerchantPaymentFiatAmount"},{"$ref":"#/components/schemas/MerchantPaymentTokenAmount"}]},"txHash":{"description":"Settlement transaction hash. Present when `settled` is `true` and an upstream settlement transaction hash is available.","type":"string"}},"required":["settled"]},"MerchantPaymentExchangeRate":{"type":"object","properties":{"from":{"type":"string","description":"Unit the payment was priced in","examples":["iso4217/EUR"]},"fromSymbol":{"type":"string","description":"Display symbol for `from`","examples":["EUR"]},"to":{"type":"string","description":"Unit the payment settles in","examples":["caip19/eip155:8453/erc20:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"]},"toSymbol":{"type":"string","description":"Display symbol for `to`","examples":["USDC"]},"rate":{"type":"string","description":"How many whole `to` units one whole `from` unit converted into, as a decimal string","examples":["1.085"]}},"required":["from","fromSymbol","to","toSymbol","rate"],"description":"Conversion applied between the payment unit and the settlement unit. Derived from the payment amount and the gross settlement amount (settlement plus fees), so it is the effective rate for this payment rather than a rate quoted independently. Omitted when the payment does not convert, or when the amounts needed to derive it are unavailable."},"MerchantPaymentRefund":{"type":"object","properties":{"status":{"type":"string","description":"Refund state. \"fully_refunded\" is the only value this API emits.","examples":["fully_refunded"]},"fullyRefundedAt":{"description":"ISO 8601 timestamp when the payment was fully refunded. Present only for fully refunded payments.","type":"string"}},"required":["status"],"description":"Refund details. Not currently populated: refund state is not yet projected into the payment read model, so this field is always omitted today. Reserved for a future release."},"MerchantPaymentsResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"paymentId":{"type":"string","description":"Unique payment identifier"},"merchant":{"type":"object","properties":{"id":{"type":"string","description":"Partner-provided merchant ID"},"name":{"description":"Merchant display name","type":"string"},"iconUrl":{"description":"Merchant logo URL","type":["string","null"]}},"required":["id"]},"referenceId":{"type":"string","description":"Idempotency / reference ID provided at payment creation"},"status":{"type":"string","enum":["requires_action","processing","succeeded","failed","expired"]},"isTerminal":{"type":"boolean","description":"Whether the payment has reached a final state"},"fiatAmount":{"$ref":"#/components/schemas/MerchantPaymentFiatAmount"},"tokenAmount":{"$ref":"#/components/schemas/MerchantPaymentTokenAmount"},"buyer":{"description":"Buyer wallet information","type":"object","properties":{"accountCaip10":{"type":"string","description":"Buyer address as a [CAIP-10](https://standards.chainagnostic.org/CAIPs/caip-10) account ID","examples":["eip155:8453:0x1234567890abcdef1234567890abcdef12345678"]},"accountProviderName":{"description":"Wallet provider name","examples":["MetaMask"],"type":"string"},"accountProviderIcon":{"description":"Wallet provider logo URL","type":"string"}},"required":["accountCaip10"]},"transaction":{"description":"On-chain transaction details","type":"object","properties":{"networkId":{"type":"string","description":"Numeric chain ID","examples":["8453"]},"hash":{"description":"On-chain transaction hash","type":"string"}},"required":["networkId"]},"fees":{"description":"Fee breakdown derived from payment option data. Omitted when total fee data is unavailable.","type":"object","properties":{"total":{"anyOf":[{"$ref":"#/components/schemas/MerchantPaymentFiatAmount"},{"$ref":"#/components/schemas/MerchantPaymentTokenAmount"}],"description":"Total fee amount."},"fixed":{"description":"Fixed fee component.","anyOf":[{"$ref":"#/components/schemas/MerchantPaymentFiatAmount"},{"$ref":"#/components/schemas/MerchantPaymentTokenAmount"}]},"percentage":{"description":"Percentage fee component as a decimal percentage string, not a ratio. For example, \"0.4\" means 0.4%.","type":"string"}},"required":["total"]},"settlement":{"$ref":"#/components/schemas/MerchantPaymentSettlement"},"exchangeRate":{"$ref":"#/components/schemas/MerchantPaymentExchangeRate"},"refund":{"$ref":"#/components/schemas/MerchantPaymentRefund"},"paymentUrl":{"description":"Hosted payment page URL for this payment. The hosted page reflects the payment's current state.","type":"string","format":"uri"},"createdAt":{"type":"string","description":"ISO 8601 timestamp"},"expiresAt":{"description":"ISO 8601 timestamp of the payment deadline, present only when the payment has an expiration","type":"string"},"lastUpdatedAt":{"type":"string","description":"ISO 8601 timestamp"},"settledAt":{"description":"ISO 8601 timestamp, present only when `settlement.settled` is `true` and a timestamp is available","type":"string"}},"required":["paymentId","merchant","referenceId","status","isTerminal","createdAt","lastUpdatedAt"]}},"nextCursor":{"description":"Cursor for the next page, or null if no more results","type":["string","null"]},"stats":{"type":"object","properties":{"totalRevenue":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number","description":"Revenue amount in currency's standard unit"},"currency":{"type":"string","description":"ISO 4217 currency code","examples":["USD"]}},"required":["amount","currency"]},"description":"Total revenue over succeeded payments, converted to USD. Always exactly one element — a merchant with no volume gets a zero rather than an empty array. Kept as an array for backwards compatibility."},"totalTransactions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Total payments matching the query"},"totalCustomers":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Unique buyers matching the query"}},"required":["totalRevenue","totalTransactions","totalCustomers"],"description":"Aggregate statistics for the query"}},"required":["data","nextCursor","stats"]}},"securitySchemes":{"API Key":{"type":"apiKey","in":"header","name":"Api-Key"},"ApiKey":{"type":"apiKey","in":"header","name":"Api-Key","description":"Private API key for wallet authentication"},"AppId":{"type":"apiKey","in":"header","name":"App-Id","description":"Public App ID for wallet authentication. When using this auth mode, the Client-Id header is also required."},"apiKey":{"type":"apiKey","in":"header","name":"Api-Key","description":"Partner API key."}}},"security":[{"API Key":[]},{"ApiKey":[]},{"AppId":[]}]}}}}]

Bybit Pay PSP order webhook

AuthorizationCopy Anchor Link

Request BodyCopy Anchor Link

Response BodyCopy Anchor Link

Authorization

Request Body

Response Body