docsNav.backToDocs

docsQuickstart.title

docsQuickstart.subtitle

1

docsQuickstart.step1Title

docsQuickstart.step1Desc1 Kustodia docsQuickstart.step1Desc2 docsQuickstart.step1Desc3 docsQuickstart.step1Desc4

docsQuickstart.keyPrefixes

  • kust_test_docsQuickstart.testMode
  • kust_live_docsQuickstart.productionMode
2

docsQuickstart.step2Title

docsQuickstart.step2Desc

curl -X POST https://api.kustodia.app/api/v1/payments \
  -H "Content-Type: application/json" \
  -H "X-API-Key: kust_test_tu_clave_aqui" \
  -d '{
    "amount": 15000,
    "payer_email": "comprador@ejemplo.com",
    "recipient_email": "vendedor@ejemplo.com",
    "description": "Compra segura en mi marketplace"
  }'
3

docsQuickstart.step3Title

docsQuickstart.step3Desc

{
  "success": true,
  "data": {
    "id": "a1b2c3d4-...",
    "amount": 15000.00,
    "status": "pending_deposit",
    "deposit_clabe": "646180157000000123",
    "created_at": "2026-02-07T00:00:00Z"
  }
}
4

docsQuickstart.step4Title

docsQuickstart.step4Desc

curl -X POST https://api.kustodia.app/api/v1/webhooks/configure \
  -H "Authorization: Bearer TU_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://tu-marketplace.com/webhooks/kustodia",
    "events": ["payment.deposited", "payment.released"]
  }'
5

docsQuickstart.step5Title

docsQuickstart.step5Desc

<iframe
  src="https://app.kustodia.app/widget/{payment_id}"
  width="100%"
  height="600"
  frameborder="0"
></iframe>