{
  "info": {
    "name": "Mosi x Gran Kiosko - flujo links y transferencias",
    "description": "Flujo Mosi: 0 token (POST /api/auth/token) -> 1 links -> 2 webhook del comercio -> 3 transferencia Crezcamos -> 4 confirmacion al motor. Nadie toca Keycloak. Completar merchant_secret y webhook_secret (no se versionan). El secreto debe vivir en un servidor, no en una app movil.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "item": [
    {
      "name": "0. Autenticacion",
      "item": [
        {
          "name": "0.1 Obtener token (POST /api/auth/token)",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test(\"HTTP 200\",()=>pm.response.to.have.status(200));",
                  "pm.collectionVariables.set(\"access_token\", pm.response.json().access_token);"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "{{api_url}}/api/auth/token",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"client_id\": \"{{merchant_id}}\",\n  \"client_secret\": \"{{merchant_secret}}\"\n}"
            },
            "description": "Cambia client_id/client_secret del comercio por un JWT (dura ~300 s). Sin Keycloak publico. El secreto va en la variable merchant_secret, no se versiona."
          }
        }
      ]
    },
    {
      "name": "1. Links de pago",
      "item": [
        {
          "name": "2.1 Crear link",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{access_token}}"
              },
              {
                "key": "Content-Type",
                "value": "application/vnd.api+json"
              }
            ],
            "url": "{{api_url}}/api/payment-links",
            "description": "",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": {\n    \"type\": \"payment_link\",\n    \"attributes\": {\n      \"concept\": \"Pedido {{order_ref}}\",\n      \"description\": \"Gran Kiosko - pedido {{order_ref}}\",\n      \"reference\": \"{{order_ref}}\",\n      \"currency\": \"COP\",\n      \"amount\": \"{{amount}}\",\n      \"vat_enabled\": false,\n      \"max_payment_count\": 1,\n      \"expires_at\": \"2026-12-31T23:59:59Z\",\n      \"accepted_payment_methods\": [\n        \"cuentas_crezcamos\",\n        \"pse\",\n        \"card\"\n      ],\n      \"customer_data_policy\": \"hidden\",\n      \"shipping_data_policy\": \"hidden\"\n    }\n  }\n}"
            }
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test(\"HTTP 201\",()=>pm.response.to.have.status(201));",
                  "const a=pm.response.json().data;",
                  "pm.collectionVariables.set(\"link_id\",a.id);",
                  "pm.collectionVariables.set(\"link_token\",a.attributes.token);",
                  "pm.collectionVariables.set(\"link_total\",a.attributes.total);",
                  "pm.collectionVariables.set(\"link_url\",a.attributes.url);",
                  "pm.test(\"estado active\",()=>pm.expect(a.attributes.state).to.eql(\"active\"));"
                ]
              }
            }
          ]
        },
        {
          "name": "2.2 Listar links",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{access_token}}"
              }
            ],
            "url": "{{api_url}}/api/payment-links",
            "description": ""
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test(\"HTTP 200\",()=>pm.response.to.have.status(200));"
                ]
              }
            }
          ]
        },
        {
          "name": "2.3 Ver link",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{access_token}}"
              }
            ],
            "url": "{{api_url}}/api/payment-links/{{link_id}}",
            "description": ""
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test(\"HTTP 200\",()=>pm.response.to.have.status(200));"
                ]
              }
            }
          ]
        },
        {
          "name": "2.4 Revocar link",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{access_token}}"
              }
            ],
            "url": "{{api_url}}/api/payment-links/{{link_id}}/revoke",
            "description": "Opcional. Reactivar con 2.5 antes de seguir el flujo de pago."
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test(\"HTTP 200\",()=>pm.response.to.have.status(200));"
                ]
              }
            }
          ]
        },
        {
          "name": "2.5 Reactivar link",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{access_token}}"
              }
            ],
            "url": "{{api_url}}/api/payment-links/{{link_id}}/reactivate",
            "description": ""
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test(\"HTTP 200\",()=>pm.response.to.have.status(200));"
                ]
              }
            }
          ]
        }
      ]
    },
    {
      "name": "2. Webhook del comercio",
      "item": [
        {
          "name": "W.1 Registrar webhook del comercio",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{access_token}}"
              },
              {
                "key": "Content-Type",
                "value": "application/vnd.api+json"
              }
            ],
            "url": "{{api_url}}/api/merchant-webhooks",
            "description": "El secreto de firma (whsec_...) llega UNA sola vez en meta.secret; el script lo guarda en merchant_webhook_secret. La url debe ser publica y responder 2xx.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": {\n    \"type\": \"merchant_webhook\",\n    \"attributes\": {\n      \"url\": \"{{merchant_webhook_url}}\",\n      \"description\": \"Mosi - pagos Gran Kiosko\",\n      \"events\": [\n        \"payment.*\"\n      ]\n    }\n  }\n}"
            }
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test(\"HTTP 201\",()=>pm.response.to.have.status(201));",
                  "const d=pm.response.json();",
                  "pm.collectionVariables.set(\"merchant_webhook_id\", d.data.id);",
                  "pm.collectionVariables.set(\"merchant_webhook_secret\", d.meta.secret);"
                ]
              }
            }
          ]
        },
        {
          "name": "W.2 Listar webhooks",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{access_token}}"
              }
            ],
            "url": "{{api_url}}/api/merchant-webhooks",
            "description": ""
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test(\"HTTP 200\",()=>pm.response.to.have.status(200));"
                ]
              }
            }
          ]
        },
        {
          "name": "W.3 Ver webhook",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{access_token}}"
              }
            ],
            "url": "{{api_url}}/api/merchant-webhooks/{{merchant_webhook_id}}",
            "description": ""
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test(\"HTTP 200\",()=>pm.response.to.have.status(200));"
                ]
              }
            }
          ]
        },
        {
          "name": "W.4 Actualizar webhook",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{access_token}}"
              },
              {
                "key": "Content-Type",
                "value": "application/vnd.api+json"
              }
            ],
            "url": "{{api_url}}/api/merchant-webhooks/{{merchant_webhook_id}}",
            "description": "",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": {\n    \"type\": \"merchant_webhook\",\n    \"id\": \"{{merchant_webhook_id}}\",\n    \"attributes\": {\n      \"events\": [\n        \"payment.approved\",\n        \"payment.rejected\"\n      ]\n    }\n  }\n}"
            }
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test(\"HTTP 200\",()=>pm.response.to.have.status(200));"
                ]
              }
            }
          ]
        },
        {
          "name": "W.5 Rotar secreto de firma",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{access_token}}"
              }
            ],
            "url": "{{api_url}}/api/merchant-webhooks/{{merchant_webhook_id}}/rotate-secret",
            "description": "El secreto anterior deja de servir."
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test(\"HTTP 200\",()=>pm.response.to.have.status(200));",
                  "pm.collectionVariables.set(\"merchant_webhook_secret\", pm.response.json().meta.secret);"
                ]
              }
            }
          ]
        }
      ]
    },
    {
      "name": "3. Transferencia entre cuentas Crezcamos",
      "item": [
        {
          "name": "3.1 Deep link que arma la pagina",
          "request": {
            "method": "GET",
            "header": [],
            "url": "{{pay_url}}/l/{{link_token}}",
            "description": "Abrir en el navegador. Al elegir Cuenta Crezcamos la app recibe: mosi://transfer?amount={{link_total}}&reference={{order_ref}}&token={{link_token}}&merchant=..."
          }
        },
        {
          "name": "3.2 Login Crezcamos",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "x-api-key",
                "value": "{{crezcamos_api_key}}",
                "disabled": true
              }
            ],
            "url": "{{crezcamos_url}}/payments-authentication/v1/login",
            "description": "Sandbox: acepta cualquier usuario/clave. Real: requiere x-api-key y x-hash.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"username\": \"{{crezcamos_user}}\",\n  \"password\": \"{{crezcamos_password}}\"\n}"
            }
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test(\"HTTP 200\",()=>pm.response.to.have.status(200));",
                  "pm.collectionVariables.set(\"cz_token\", pm.response.json().data.token);"
                ]
              }
            }
          ]
        },
        {
          "name": "3.3 Existe cuenta destino",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{cz_token}}"
              }
            ],
            "url": "{{crezcamos_url}}/payments-savings/v1/savings/accounts/{{account_to}}/exist",
            "description": "Sandbox: termina en 0000 -> no existe (26); 9999 -> false."
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test(\"HTTP 200\",()=>pm.response.to.have.status(200));",
                  "pm.test(\"cuenta existe\",()=>pm.expect(pm.response.json().data).to.eql(true));"
                ]
              }
            }
          ]
        },
        {
          "name": "3.4 Transferir entre cuentas",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{cz_token}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "{{crezcamos_url}}/payments-transfers/v1/transfers/accounts",
            "description": "Idempotente por transactionId. Sandbox: montos terminados en 300,303,307,309,310,313,314,315,329,332 devuelven ese error.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"transactionId\": \"{{transaction_id}}\",\n  \"documentType\": \"CC\",\n  \"documentNumber\": \"{{document_number}}\",\n  \"accountFrom\": \"{{account_from}}\",\n  \"accountTo\": \"{{account_to}}\",\n  \"amount\": \"{{link_total}}.00\",\n  \"description\": \"Gran Kiosko - {{order_ref}}\"\n}"
            }
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test(\"HTTP 200\",()=>pm.response.to.have.status(200));",
                  "const b=pm.response.json();",
                  "pm.test(\"code 00\",()=>pm.expect(b.code).to.eql(\"00\"));",
                  "pm.collectionVariables.set(\"transfer_reference\", b.data && b.data.reference);"
                ]
              }
            }
          ]
        }
      ]
    },
    {
      "name": "4. Confirmacion al motor",
      "item": [
        {
          "name": "4.1 Confirmar pago APPROVED",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "X-Crezcamos-Webhook-Secret",
                "value": "{{webhook_secret}}"
              },
              {
                "key": "X-Crezcamos-Event-Id",
                "value": "mosi-{{transaction_id}}-approved"
              }
            ],
            "url": "{{api_url}}/webhooks/crezcamos/pse-payments",
            "description": "Primer evento DEBE llevar payment_link_token. amount debe ser igual al total del link (si no: 422). Repetir el event_id responde duplicate.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"status\": \"APPROVED\",\n  \"rail\": \"cuentas_crezcamos\",\n  \"payment_link_token\": \"{{link_token}}\",\n  \"provider_payment_id\": \"{{transaction_id}}\",\n  \"reference\": \"{{transfer_reference}}\",\n  \"amount\": \"{{link_total}}\",\n  \"currency\": \"COP\"\n}"
            }
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test(\"HTTP 200\",()=>pm.response.to.have.status(200));",
                  "pm.test(\"ok\",()=>pm.expect(pm.response.json().ok).to.eql(true));"
                ]
              }
            }
          ]
        },
        {
          "name": "4.2 Confirmar pago REJECTED (alternativo)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "X-Crezcamos-Webhook-Secret",
                "value": "{{webhook_secret}}"
              },
              {
                "key": "X-Crezcamos-Event-Id",
                "value": "mosi-{{transaction_id}}-rejected"
              }
            ],
            "url": "{{api_url}}/webhooks/crezcamos/pse-payments",
            "description": "Usar en lugar de 4.1.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"status\": \"REJECTED\",\n  \"rail\": \"cuentas_crezcamos\",\n  \"payment_link_token\": \"{{link_token}}\",\n  \"provider_payment_id\": \"{{transaction_id}}\",\n  \"amount\": \"{{link_total}}\",\n  \"currency\": \"COP\",\n  \"reason\": \"INSUFFICIENT_FUNDS\"\n}"
            }
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test(\"HTTP 200\",()=>pm.response.to.have.status(200));"
                ]
              }
            }
          ]
        },
        {
          "name": "4.3 Verificar link pagado",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{access_token}}"
              }
            ],
            "url": "{{api_url}}/api/payment-links/{{link_id}}",
            "description": "",
            "body": {
              "mode": "raw",
              "raw": "[\n  \"pm.test(\\\"HTTP 200\\\",()=>pm.response.to.have.status(200));\",\n  \"pm.test(\\\"link paid\\\",()=>pm.expect(pm.response.json().data.attributes.state).to.eql(\\\"paid\\\"));\"\n]"
            }
          }
        }
      ]
    }
  ],
  "variable": [
    {
      "key": "api_url",
      "value": "https://api.crezcapay.probamos.co"
    },
    {
      "key": "pay_url",
      "value": "https://pay.crezcapay.probamos.co"
    },
    {
      "key": "crezcamos_url",
      "value": "https://sandbox.crezcapay.probamos.co"
    },
    {
      "key": "webhook_secret",
      "value": ""
    },
    {
      "key": "crezcamos_user",
      "value": "mosi"
    },
    {
      "key": "crezcamos_password",
      "value": "x"
    },
    {
      "key": "crezcamos_api_key",
      "value": ""
    },
    {
      "key": "order_ref",
      "value": "pedido-1042"
    },
    {
      "key": "amount",
      "value": "50000"
    },
    {
      "key": "account_from",
      "value": "1111111111"
    },
    {
      "key": "account_to",
      "value": "2222222222"
    },
    {
      "key": "document_number",
      "value": "123456789"
    },
    {
      "key": "transaction_id",
      "value": "mosi-0001"
    },
    {
      "key": "access_token",
      "value": ""
    },
    {
      "key": "link_id",
      "value": ""
    },
    {
      "key": "link_token",
      "value": ""
    },
    {
      "key": "link_total",
      "value": ""
    },
    {
      "key": "link_url",
      "value": ""
    },
    {
      "key": "cz_token",
      "value": ""
    },
    {
      "key": "transfer_reference",
      "value": ""
    },
    {
      "key": "merchant_webhook_url",
      "value": "https://mi-servidor.example.com/webhooks/pagos"
    },
    {
      "key": "merchant_webhook_id",
      "value": ""
    },
    {
      "key": "merchant_webhook_secret",
      "value": ""
    },
    {
      "key": "merchant_id",
      "value": "00000000-0000-0000-0000-0000000000a1"
    },
    {
      "key": "merchant_secret",
      "value": ""
    }
  ]
}