[{"data":1,"prerenderedAt":407},["ShallowReactive",2],{"content:/docs/transaction":3},{"id":4,"title":5,"body":6,"description":400,"extension":401,"meta":402,"navigation":57,"path":403,"seo":404,"stem":405,"__hash__":406},"content/fr/docs/transaction/index.md","Transactions",{"type":7,"value":8,"toc":394},"minimark",[9,13,17,22,113,167,177,181,250,260,264,284,315,319,322,382,390],[10,11,5],"h1",{"id":12},"transactions",[14,15,16],"p",{},"Une transaction est la source de vérité unique d'un paiement. Vous la créez ; le\nswitch la route vers un fournisseur ; le statut final arrive sur votre callback.",[18,19,21],"h2",{"id":20},"créer-une-transaction","Créer une transaction",[23,24,29],"pre",{"className":25,"code":26,"language":27,"meta":28,"style":28},"language-http shiki shiki-themes github-dark","POST /api/payments/transaction/\nAuthorization: Bearer \u003Ctoken>\nContent-Type: application/json\n\n{\n  \"merchant_reference\": \"INV-2026-0001\",\n  \"amount\": \"100.00\",\n  \"currency\": \"CDF\",\n  \"customer_number\": \"0810000000\",\n  \"operation\": \"debit\",\n  \"service\": \"\u003Cservice-id>\",\n  \"callback_url\": \"https://your-app/payments/callback\"\n}\n","http","",[30,31,32,40,46,52,59,65,71,77,83,89,95,101,107],"code",{"__ignoreMap":28},[33,34,37],"span",{"class":35,"line":36},"line",1,[33,38,39],{},"POST /api/payments/transaction/\n",[33,41,43],{"class":35,"line":42},2,[33,44,45],{},"Authorization: Bearer \u003Ctoken>\n",[33,47,49],{"class":35,"line":48},3,[33,50,51],{},"Content-Type: application/json\n",[33,53,55],{"class":35,"line":54},4,[33,56,58],{"emptyLinePlaceholder":57},true,"\n",[33,60,62],{"class":35,"line":61},5,[33,63,64],{},"{\n",[33,66,68],{"class":35,"line":67},6,[33,69,70],{},"  \"merchant_reference\": \"INV-2026-0001\",\n",[33,72,74],{"class":35,"line":73},7,[33,75,76],{},"  \"amount\": \"100.00\",\n",[33,78,80],{"class":35,"line":79},8,[33,81,82],{},"  \"currency\": \"CDF\",\n",[33,84,86],{"class":35,"line":85},9,[33,87,88],{},"  \"customer_number\": \"0810000000\",\n",[33,90,92],{"class":35,"line":91},10,[33,93,94],{},"  \"operation\": \"debit\",\n",[33,96,98],{"class":35,"line":97},11,[33,99,100],{},"  \"service\": \"\u003Cservice-id>\",\n",[33,102,104],{"class":35,"line":103},12,[33,105,106],{},"  \"callback_url\": \"https://your-app/payments/callback\"\n",[33,108,110],{"class":35,"line":109},13,[33,111,112],{},"}\n",[114,115,116,128,142,160],"ul",{},[117,118,119,122,123,127],"li",{},[30,120,121],{},"merchant_reference"," est ",[124,125,126],"strong",{},"votre"," référence ; elle doit être unique par marchand.",[117,129,130,133,134,137,138,141],{},[30,131,132],{},"operation"," vaut ",[30,135,136],{},"\"debit\""," (encaissement) ou ",[30,139,140],{},"\"credit\""," (décaissement).",[117,143,144,147,148,151,152,155,156,159],{},[30,145,146],{},"provider_code_name"," est optionnel — omettez-le et le ",[124,149,150],{},"répartiteur de charge","\nchoisit le fournisseur ; fournissez ",[30,153,154],{},"\"freshpay\""," / ",[30,157,158],{},"\"unipesa\""," pour en forcer un.",[117,161,162,163,166],{},"Le statut est contrôlé par le serveur et démarre à ",[30,164,165],{},"Received",". L'argent ne bouge\njamais de façon synchrone ici — le switch dispatche de manière asynchrone.",[14,168,169,170,173,174,176],{},"La réponse est la transaction créée, incluant la ",[30,171,172],{},"reference"," canonique de\nPayRouter et le ",[30,175,146],{}," résolu.",[18,178,180],{"id":179},"statuts","Statuts",[182,183,184,197],"table",{},[185,186,187],"thead",{},[188,189,190,194],"tr",{},[191,192,193],"th",{},"Statut",[191,195,196],{},"Signification",[198,199,200,210,220,230,240],"tbody",{},[188,201,202,207],{},[203,204,205],"td",{},[30,206,165],{},[203,208,209],{},"Créée, en file pour dispatch",[188,211,212,217],{},[203,213,214],{},[30,215,216],{},"Pending",[203,218,219],{},"Acceptée par le fournisseur, en attente du callback",[188,221,222,227],{},[203,223,224],{},[30,225,226],{},"Success",[203,228,229],{},"Terminée",[188,231,232,237],{},[203,233,234],{},[30,235,236],{},"Failed",[203,238,239],{},"Rejetée ou échouée",[188,241,242,247],{},[203,243,244],{},[30,245,246],{},"Cancelled",[203,248,249],{},"Annulée (terminal)",[14,251,252,253,155,255,155,257,259],{},"Les états terminaux (",[30,254,226],{},[30,256,236],{},[30,258,246],{},") sont immuables.",[18,261,263],{"id":262},"lire-une-transaction","Lire une transaction",[23,265,267],{"className":25,"code":266,"language":27,"meta":28,"style":28},"GET /api/payments/transaction/                       # vos transactions (paginées)\nGET /api/payments/transaction/\u003Creference>/           # une transaction\nGET /api/payments/transaction/\u003Creference>/history/   # historique des statuts\n",[30,268,269,274,279],{"__ignoreMap":28},[33,270,271],{"class":35,"line":36},[33,272,273],{},"GET /api/payments/transaction/                       # vos transactions (paginées)\n",[33,275,276],{"class":35,"line":42},[33,277,278],{},"GET /api/payments/transaction/\u003Creference>/           # une transaction\n",[33,280,281],{"class":35,"line":48},[33,282,283],{},"GET /api/payments/transaction/\u003Creference>/history/   # historique des statuts\n",[14,285,286,287,290,291,294,295,290,298,290,300,290,302,305,306,290,309,290,312,314],{},"La liste prend en charge ",[30,288,289],{},"?search=",", ",[30,292,293],{},"?ordering=-created_at"," et des filtres\n(",[30,296,297],{},"transaction_status",[30,299,132],{},[30,301,146],{},[30,303,304],{},"service","). Chaque ligne\ninclut des libellés lisibles : ",[30,307,308],{},"currency_abbr",[30,310,311],{},"service_name",[30,313,146],{},".",[18,316,318],{"id":317},"paiements-groupés","Paiements groupés",[14,320,321],{},"Pour les décaissements en masse, regroupez les bénéficiaires et payez-les ensemble :",[182,323,324,334],{},[185,325,326],{},[188,327,328,331],{},[191,329,330],{},"Endpoint",[191,332,333],{},"Objet",[198,335,336,349,362,372],{},[188,337,338,343],{},[203,339,340],{},[30,341,342],{},"POST /api/payments/payment-groups/",[203,344,345,346],{},"créer un groupe ",[30,347,348],{},"{ name }",[188,350,351,356],{},[203,352,353],{},[30,354,355],{},"POST /api/payments/payment-request-members/",[203,357,358,359],{},"ajouter un membre ",[30,360,361],{},"{ payment_group, name, phone_number, amount, currency }",[188,363,364,369],{},[203,365,366],{},[30,367,368],{},"GET /api/payments/payment-requests/?payment_group=\u003Cid>",[203,370,371],{},"demandes d'un groupe",[188,373,374,379],{},[203,375,376],{},[30,377,378],{},"GET /api/payments/payment-transactions/",[203,380,381],{},"historique de paiement par membre",[383,384],"doc-nav",{":first-page":385,":last-page":385,"next-title":386,"next-url":387,"previous-title":388,"previous-url":389},"false","Callbacks","/docs/callback","Authentification","/docs/authentication",[391,392,393],"style",{},"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);}",{"title":28,"searchDepth":42,"depth":42,"links":395},[396,397,398,399],{"id":20,"depth":42,"text":21},{"id":179,"depth":42,"text":180},{"id":262,"depth":42,"text":263},{"id":317,"depth":42,"text":318},"Créer et suivre les paiements avec l'API PayRouter","md",{},"/fr/docs/transaction",{"title":5,"description":400},"fr/docs/transaction/index","A2EPPPzIAKoZkLEQymrgA50BFHu4FSZ9rD37jJRP1no",1781822932871]