{
	"info": {
		"_postman_id": "nelsius-pay-module8",
		"name": "Nelsius Pay - Module 8: Intégration & API",
		"description": "Documentation complète pour la gestion des clés API, les Webhooks et l'utilisation de l'API externe (v1).",
		"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
	},
	"item": [
		{
			"name": "8.1 - Gestion Clés & Webhooks (Dashboard)",
			"description": "Ces routes nécessitent une authentification Bearer Token (Utilisateur connecté au Dashboard).",
			"item": [
				{
					"name": "GET Liste des clés API",
					"request": {
						"method": "GET",
						"header": [
							{
								"key": "Authorization",
								"value": "Bearer {{token}}",
								"type": "text"
							},
							{
								"key": "Accept",
								"value": "application/json",
								"type": "text"
							}
						],
						"url": {
							"raw": "{{base_url}}/api/integrations/keys",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"api",
								"integrations",
								"keys"
							]
						}
					},
					"response": []
				},
				{
					"name": "POST Créer une clé API",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Authorization",
								"value": "Bearer {{token}}",
								"type": "text"
							},
							{
								"key": "Accept",
								"value": "application/json",
								"type": "text"
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n    \"name\": \"Ma Boutique en Ligne\",\n    \"permissions\": [\"read\", \"write\"],\n    \"ip_whitelist\": [\"192.168.1.1\"]\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						},
						"url": {
							"raw": "{{base_url}}/api/integrations/keys",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"api",
								"integrations",
								"keys"
							]
						}
					},
					"response": []
				},
				{
					"name": "DELETE Révoker une clé",
					"request": {
						"method": "DELETE",
						"header": [
							{
								"key": "Authorization",
								"value": "Bearer {{token}}",
								"type": "text"
							},
							{
								"key": "Accept",
								"value": "application/json",
								"type": "text"
							}
						],
						"url": {
							"raw": "{{base_url}}/api/integrations/keys/1",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"api",
								"integrations",
								"keys",
								"1"
							]
						}
					},
					"response": []
				},
				{
					"name": "POST Régénérer Secret",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Authorization",
								"value": "Bearer {{token}}",
								"type": "text"
							},
							{
								"key": "Accept",
								"value": "application/json",
								"type": "text"
							}
						],
						"url": {
							"raw": "{{base_url}}/api/integrations/keys/1/regenerate",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"api",
								"integrations",
								"keys",
								"1",
								"regenerate"
							]
						}
					},
					"response": []
				},
				{
					"name": "GET Liste des Webhooks",
					"request": {
						"method": "GET",
						"header": [
							{
								"key": "Authorization",
								"value": "Bearer {{token}}",
								"type": "text"
							},
							{
								"key": "Accept",
								"value": "application/json",
								"type": "text"
							}
						],
						"url": {
							"raw": "{{base_url}}/api/integrations/webhooks",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"api",
								"integrations",
								"webhooks"
							]
						}
					},
					"response": []
				},
				{
					"name": "POST Ajouter Webhook",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Authorization",
								"value": "Bearer {{token}}",
								"type": "text"
							},
							{
								"key": "Accept",
								"value": "application/json",
								"type": "text"
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n    \"url\": \"https://mon-site.com/callback\",\n    \"events\": [\"payment.completed\", \"payment.failed\"],\n    \"description\": \"Callback principal\"\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						},
						"url": {
							"raw": "{{base_url}}/api/integrations/webhooks",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"api",
								"integrations",
								"webhooks"
							]
						}
					},
					"response": []
				}
			]
		},
		{
			"name": "8.2 - API Externe (Pour Développeurs)",
			"description": "Ces routes nécessitent le header `X-API-KEY`. Elles sont destinées à être utilisées par vos systèmes externes.",
			"item": [
				{
					"name": "GET Opérateurs Disponibles",
					"request": {
						"method": "GET",
						"header": [
							{
								"key": "X-API-KEY",
								"value": "{{api_key}}",
								"type": "text"
							},
							{
								"key": "Accept",
								"value": "application/json",
								"type": "text"
							}
						],
						"url": {
							"raw": "{{base_url}}/api/v1/payments/mobile-money/operators?country=CM",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"api",
								"v1",
								"payments",
								"mobile-money",
								"operators"
							],
							"query": [
								{
									"key": "country",
									"value": "CM"
								}
							]
						}
					},
					"response": []
				},
				{
					"name": "POST Initier Paiement Mobile Money",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "X-API-KEY",
								"value": "{{api_key}}",
								"type": "text"
							},
							{
								"key": "Content-Type",
								"value": "application/json",
								"type": "text"
							},
							{
								"key": "Accept",
								"value": "application/json",
								"type": "text"
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n    \"operator\": \"orange_money\",\n    \"phone\": \"699000000\",\n    \"amount\": 500,\n    \"currency\": \"XAF\",\n    \"description\": \"Achat en ligne #12345\"\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						},
						"url": {
							"raw": "{{base_url}}/api/v1/payments/mobile-money",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"api",
								"v1",
								"payments",
								"mobile-money"
							]
						}
					},
					"response": []
				},
				{
					"name": "GET Vérifier Statut Paiement",
					"request": {
						"method": "GET",
						"header": [
							{
								"key": "X-API-KEY",
								"value": "{{api_key}}",
								"type": "text"
							},
							{
								"key": "Accept",
								"value": "application/json",
								"type": "text"
							}
						],
						"url": {
							"raw": "{{base_url}}/api/v1/payments/mobile-money/TXN_REFERENCE_ID",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"api",
								"v1",
								"payments",
								"mobile-money",
								"TXN_REFERENCE_ID"
							]
						}
					},
					"response": []
				},
				{
					"name": "GET Détails Transaction",
					"request": {
						"method": "GET",
						"header": [
							{
								"key": "X-API-KEY",
								"value": "{{api_key}}",
								"type": "text"
							},
							{
								"key": "Accept",
								"value": "application/json",
								"type": "text"
							}
						],
						"url": {
							"raw": "{{base_url}}/api/v1/transactions/1",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"api",
								"v1",
								"transactions",
								"1"
							]
						}
					},
					"response": []
				}
			]
		}
	],
	"variable": [
		{
			"key": "base_url",
			"value": "http://localhost:8000"
		},
		{
			"key": "token",
			"value": "VOTRE_JWT_TOKEN"
		},
		{
			"key": "api_key",
			"value": "pk_test_XXXXXXXXXXXXXXXXXX"
		}
	]
}