Reference API
Créer une demande (Voyage)
POST /api/v1/partner/contracts/voyage/classic — créer une demande de contrat avec lien de paiement.
But
Créer une demande de contrat d'assurance voyage côté partenaire. La réponse contient un lien de paiement et un statut métier initial.
Cette page est interactive: tu peux lire le schéma réel, voir les exemples générés depuis Swagger et tester l'endpoint.
Résumé rapide
- Méthode:
POST - Route:
/api/v1/partner/contracts/voyage/classic - Auth:
x-api-keypartenaire ou JWT - Résultat:
reference,contractStatus,payment.paymentUrl
Points d'attention
contractdoit respecter les règles ASKIA (champs obligatoires:zn,duree,numPassport, etc.).- La tarification (Prime Nette, Accessoires, Taxes, FGA) est dynamiquement générée par ASKIA au moment de la demande.
Référence interactive
AuthorizationBearer <token>
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
curl -X POST "https://api.assurance.kiriku.app/api/v1/partner/contracts/voyage/classic" \ -H "Content-Type: application/json" \ -d '{ "contract": { "cliCode": "string", "zn": "string", "duree": 0, "effet": "string", "numPassport": "string", "dtDeliv": "string", "dtExpir": "string", "lieuNais": "string", "lieuDepart": "string", "lieuDest": "string" }, "returnUrl": "https://partner.com/payment/success", "cancelUrl": "https://partner.com/payment/failure" }'Empty
Et ensuite
- Rediriger l'utilisateur vers
payment.paymentUrl. - Attendre le webhook partenaire ou relire l'état avec
GET /api/v1/partner/contracts/requests/{reference}.
Flow partenaire
Comprendre le parcours complet de la demande au contrat actif.
Reference API
Tester les endpoints et consulter les schemas OpenAPI reels.
Webhooks sortants
Verifier la signature et traiter les emissions en temps reel.
Go-live checklist
Valider les prerequis de production avant ouverture partenaire.