[{"data":1,"prerenderedAt":433},["ShallowReactive",2],{"docs:\u002Fdocs\u002Fprimeros-pasos":3,"docs-surround:\u002Fdocs\u002Fprimeros-pasos":408,"docs-navigation":417},{"id":4,"title":5,"body":6,"description":400,"extension":401,"meta":402,"navigation":403,"path":404,"seo":405,"stem":406,"__hash__":407},"docs\u002Fdocs\u002F1.primeros-pasos.md","Primeros pasos",{"type":7,"value":8,"toc":392},"minimark",[9,14,41,45,49,52,101,108,112,122,125,129,140,175,184,305,314,318,345,349,388],[10,11,13],"h2",{"id":12},"_1-crea-tu-cuenta-y-conecta-wompi","1. Crea tu cuenta y conecta Wompi",[15,16,17,21,38],"ol",{},[18,19,20],"li",{},"Crea tu cuenta en el panel de Paygumi y registra los datos de tu empresa.",[18,22,23,24,28,29,33,34,37],{},"En ",[25,26,27],"strong",{},"Configuración → Wompi",", registra las llaves de tu cuenta de Wompi para cada entorno que vayas a usar: llave pública, llave privada, secreto de integridad y secreto de eventos. Empieza con las de sandbox de Wompi (",[30,31,32],"code",{},"pub_test_…",", ",[30,35,36],{},"prv_test_…",").",[18,39,40],{},"Copia en tu cuenta de Wompi la URL de eventos que te muestra el panel, para que Wompi le informe a Paygumi el resultado de cada transacción.",[42,43,44],"p",{},"Los pagos se cobran en tu cuenta de Wompi y el dinero llega a ella directamente: Paygumi no es intermediario de fondos.",[10,46,48],{"id":47},"_2-sandbox-y-producción","2. Sandbox y producción",[42,50,51],{},"Trabajas en los dos entornos a la vez, cada uno con sus propios datos. La API key elige el entorno de cada petición:",[53,54,55,71],"table",{},[56,57,58],"thead",{},[59,60,61,65,68],"tr",{},[62,63,64],"th",{},"Prefijo de la API key",[62,66,67],{},"Entorno",[62,69,70],{},"Wompi",[72,73,74,88],"tbody",{},[59,75,76,82,85],{},[77,78,79],"td",{},[30,80,81],{},"pgm_test_…",[77,83,84],{},"Sandbox",[77,86,87],{},"Sandbox de Wompi: tarjetas de prueba, sin dinero real",[59,89,90,95,98],{},[77,91,92],{},[30,93,94],{},"pgm_live_…",[77,96,97],{},"Producción",[77,99,100],{},"Producción de Wompi: cobros reales",[42,102,103,104,107],{},"Los planes, clientes, suscripciones, cobros, endpoints de webhook y eventos de un entorno nunca se ven desde el otro. Un id de sandbox consultado con una llave de producción responde ",[30,105,106],{},"404",".",[10,109,111],{"id":110},"_3-crea-una-api-key","3. Crea una API key",[42,113,23,114,117,118,121],{},[25,115,116],{},"Configuración → API keys"," crea una llave del entorno que necesites. ",[25,119,120],{},"Se muestra una sola vez",": guárdala en el gestor de secretos de tu backend. Paygumi solo conserva su hash, así que si la pierdes, revócala y crea otra.",[42,123,124],{},"La API key va solo en tu backend. Nunca la pongas en una app móvil, en el navegador ni en un repositorio.",[10,126,128],{"id":127},"_4-tu-primera-petición","4. Tu primera petición",[42,130,131,132,135,136,139],{},"Todas las peticiones van a ",[30,133,134],{},"https:\u002F\u002Fapi.paygumi.com"," con la llave en la cabecera ",[30,137,138],{},"Authorization",":",[141,142,147],"pre",{"className":143,"code":144,"language":145,"meta":146,"style":146},"language-bash shiki shiki-themes github-light github-dark","curl \"https:\u002F\u002Fapi.paygumi.com\u002Fv1\u002Fplans?status=ACTIVE\" \\\n  -H \"Authorization: Bearer pgm_test_...\"\n","bash","",[30,148,149,166],{"__ignoreMap":146},[150,151,154,158,162],"span",{"class":152,"line":153},"line",1,[150,155,157],{"class":156},"sScJk","curl",[150,159,161],{"class":160},"sZZnC"," \"https:\u002F\u002Fapi.paygumi.com\u002Fv1\u002Fplans?status=ACTIVE\"",[150,163,165],{"class":164},"sj4cs"," \\\n",[150,167,169,172],{"class":152,"line":168},2,[150,170,171],{"class":164},"  -H",[150,173,174],{"class":160}," \"Authorization: Bearer pgm_test_...\"\n",[42,176,177,178,183],{},"Respuesta (recortada; los campos completos están en la ",[179,180,182],"a",{"href":181},"\u002Fdocs\u002Fapi\u002Fplanes","referencia de planes","):",[141,185,189],{"className":186,"code":187,"language":188,"meta":146,"style":146},"language-json shiki shiki-themes github-light github-dark","{\n  \"data\": [\n    {\n      \"id\": \"pln_01JB86R800ABCDEFGHJKMNPQRS\",\n      \"name\": \"Pro\",\n      \"amount_in_cents\": 4990000,\n      \"currency\": \"COP\",\n      \"status\": \"ACTIVE\"\n    }\n  ],\n  \"has_more\": false\n}\n","json",[30,190,191,197,205,211,226,239,252,265,276,282,288,299],{"__ignoreMap":146},[150,192,193],{"class":152,"line":153},[150,194,196],{"class":195},"sVt8B","{\n",[150,198,199,202],{"class":152,"line":168},[150,200,201],{"class":164},"  \"data\"",[150,203,204],{"class":195},": [\n",[150,206,208],{"class":152,"line":207},3,[150,209,210],{"class":195},"    {\n",[150,212,214,217,220,223],{"class":152,"line":213},4,[150,215,216],{"class":164},"      \"id\"",[150,218,219],{"class":195},": ",[150,221,222],{"class":160},"\"pln_01JB86R800ABCDEFGHJKMNPQRS\"",[150,224,225],{"class":195},",\n",[150,227,229,232,234,237],{"class":152,"line":228},5,[150,230,231],{"class":164},"      \"name\"",[150,233,219],{"class":195},[150,235,236],{"class":160},"\"Pro\"",[150,238,225],{"class":195},[150,240,242,245,247,250],{"class":152,"line":241},6,[150,243,244],{"class":164},"      \"amount_in_cents\"",[150,246,219],{"class":195},[150,248,249],{"class":164},"4990000",[150,251,225],{"class":195},[150,253,255,258,260,263],{"class":152,"line":254},7,[150,256,257],{"class":164},"      \"currency\"",[150,259,219],{"class":195},[150,261,262],{"class":160},"\"COP\"",[150,264,225],{"class":195},[150,266,268,271,273],{"class":152,"line":267},8,[150,269,270],{"class":164},"      \"status\"",[150,272,219],{"class":195},[150,274,275],{"class":160},"\"ACTIVE\"\n",[150,277,279],{"class":152,"line":278},9,[150,280,281],{"class":195},"    }\n",[150,283,285],{"class":152,"line":284},10,[150,286,287],{"class":195},"  ],\n",[150,289,291,294,296],{"class":152,"line":290},11,[150,292,293],{"class":164},"  \"has_more\"",[150,295,219],{"class":195},[150,297,298],{"class":164},"false\n",[150,300,302],{"class":152,"line":301},12,[150,303,304],{"class":195},"}\n",[42,306,307,308,219,311,313],{},"Los montos siempre van en ",[25,309,310],{},"centavos enteros",[30,312,249],{}," son $ 49.900 COP. No uses decimales ni números de punto flotante para montos.",[10,315,317],{"id":316},"_5-configura-un-endpoint-de-webhook","5. Configura un endpoint de webhook",[42,319,23,320,323,324,327,328,331,332,335,336,340,341,344],{},[25,321,322],{},"Webhooks → Endpoints"," registra la URL ",[30,325,326],{},"https"," de tu backend que recibirá los eventos y elige a qué tipos suscribirla (o ",[30,329,330],{},"*"," para todos). Copia su secreto (",[30,333,334],{},"whsec_…",") para ",[179,337,339],{"href":338},"\u002Fdocs\u002Fwebhooks#verificar-la-firma","verificar la firma",". Puedes tener hasta 5 endpoints por entorno y enviar un ",[30,342,343],{},"ping"," de prueba desde el panel.",[10,346,348],{"id":347},"_6-antes-de-pasar-a-producción","6. Antes de pasar a producción",[350,351,352,355,358,365,382],"ul",{},[18,353,354],{},"Registra en el panel las llaves de producción de Wompi.",[18,356,357],{},"Crea en producción los planes que vas a vender (los de sandbox no se copian).",[18,359,360,361,364],{},"Crea una API key ",[30,362,363],{},"pgm_live_"," y un endpoint de webhook de producción con su propio secreto.",[18,366,367,368,370,371,33,374,377,378,381],{},"Usa ",[30,369,326],{}," en ",[30,372,373],{},"success_url",[30,375,376],{},"cancel_url"," y ",[30,379,380],{},"return_url"," (en producción es obligatorio).",[18,383,384,385,107],{},"Verifica la firma y deduplica los eventos por ",[30,386,387],{},"Paygumi-Event-Id",[389,390,391],"style",{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}",{"title":146,"searchDepth":207,"depth":207,"links":393},[394,395,396,397,398,399],{"id":12,"depth":168,"text":13},{"id":47,"depth":168,"text":48},{"id":110,"depth":168,"text":111},{"id":127,"depth":168,"text":128},{"id":316,"depth":168,"text":317},{"id":347,"depth":168,"text":348},"Crea tu cuenta, conecta Wompi, genera una API key y haz tu primera petición en sandbox.","md",{},true,"\u002Fdocs\u002Fprimeros-pasos",{"title":5,"description":400},"docs\u002F1.primeros-pasos","fOR6LNFAaQ9lkvyLJ9NC8N-LVJ6lL7X7g1asXxlTCn4",[409,413],{"title":410,"path":411,"stem":412,"children":-1},"Introducción","\u002Fdocs","docs\u002Findex",{"title":414,"path":415,"stem":416,"children":-1},"Crear una sesión de checkout","\u002Fdocs\u002Fsesiones-de-checkout","docs\u002F2.sesiones-de-checkout",[418,419,420,421,424,427,430],{"title":410,"path":411},{"title":5,"path":404},{"title":414,"path":415},{"title":422,"path":423},"Suscripciones y estados de acceso","\u002Fdocs\u002Fsuscripciones-y-acceso",{"title":425,"path":426},"Webhooks","\u002Fdocs\u002Fwebhooks",{"title":428,"path":429},"Portal del cliente","\u002Fdocs\u002Fportal-del-cliente",{"title":431,"path":432},"Idempotencia y errores","\u002Fdocs\u002Fidempotencia-y-errores",1794279319967]