Rifużjonijiet
Ipproċessa rifużjonijiet sħaħ u parzjali
Cost+ tappoġġja kemm rifużjonijiet sħaħ u parzjali fuq ordnijiet kompluti. Ir-rifużjonijiet jiġu pproċessati permezz tal-metodu ta' ħlas oriġinali użata għat-tranżazzjoni.
Ħolqien ta' Rifużjoni
Ibgħat talba POST lejn /v1/orders/\{id\}/refunds/ biex tibda rifużjoni fuq ordni kompluta.
Talba
{
"amount": 100,
"description": "Refund for item",
"merchant_order_id": "refund-001"
}Il-qasam amount juża l-unità minuri ISO 4217 tal-munita. Għal EUR, ir-rimborż ta' 1.00 EUR ifisser l-issettjar ta' amount għal 100. Biex toħroġ rifużjoni sħiħa, uża l-ammont sħiħ tal-ordni.
Oqsma tat-Talba
| Qasam | Meħtieġ | Deskrizzjoni |
|---|---|---|
amount | Iva | Ammont tar-rifużjoni fl-unità minuri ISO 4217 tal-munita |
description | Le | Raġuni għar-rifużjoni |
merchant_order_id | Le | L-ID ta' referenza tiegħek għar-rifużjoni |
extra | Le | Metadata addizzjonali bħala oġġett key-value |
Risposta
L-API tirritorna l-oġġett tar-rifużjoni bl-istatus kurrenti tagħha:
{
"id": "ref_abc123...",
"created": "2024-01-02T10:00:00.000000+00:00",
"modified": "2024-01-02T10:00:00.000000+00:00",
"amount": 100,
"currency": "EUR",
"status": "pending",
"description": "Refund for item",
"merchant_order_id": "refund-001",
"extra": null
}Oqsma tar-Risposta
| Qasam | Deskrizzjoni |
|---|---|
id | Identifikatur uniku għar-rifużjoni |
created | Timestamp meta nħolqot ir-rifużjoni |
modified | Timestamp meta ġiet aġġornata l-aħħar ir-rifużjoni |
amount | Ammont tar-rifużjoni fl-unità minuri ISO 4217 tal-munita |
currency | Munita tar-rifużjoni (taqbel mal-munita tal-ordni) |
status | Istatus kurrenti tar-rifużjoni (pending, completed, failed) |
description | Raġuni għar-rifużjoni |
merchant_order_id | L-ID ta' referenza tiegħek |
extra | Metadata addizzjonali |
Rifużjonijiet Sħaħ vs. Parzjali
- Rifużjoni sħiħa: Issettja l-
amountgħall-ammont totali tal-ordni. Il-ħlas kollu jiġi rritornat lill-klijent. - Rifużjoni parzjali: Issettja l-
amountgħal inqas mill-ammont totali tal-ordni. L-ammont speċifikat biss jiġi rritornat.
Tista' toħroġ rifużjonijiet parzjali multipli fuq l-istess ordni, sakemm l-ammont totali rrrifondut ma jaqbiżx l-ammont oriġinali tal-ordni.
{
"amount": 500,
"description": "Partial refund - damaged item"
}Ir-rifużjonijiet jistgħu jinħarġu biss fuq ordnijiet bl-istatus completed. Li tipprova tirrifondi ordni li għadha ma tlestiex se jirriżulta fi żball.
Uża l-qasam merchant_order_id biex torbot ir-rifużjonijiet lura mas-sistemi interni tiegħek. Dan huwa speċjalment utli meta toħroġ rifużjonijiet parzjali multipli fuq l-istess ordni.
Statuses tar-Rifużjoni
| Status | Deskrizzjoni |
|---|---|
pending | Ir-rifużjoni ġiet inizjata u qed tiġi pproċessata. |
completed | Ir-rifużjoni ġiet ipproċessata b'suċċess. Il-fondi jiġu rritornati lill-klijent. |
failed | Ir-rifużjoni ma setgħetx tiġi pproċessata. Ikkuntattja l-appoġġ ta' Cost+ għal assistenza. |
Il-ħin li jieħu biex l-ammont irrifondat jidher fil-kont tal-klijent jiddependi mill-metodu ta' ħlas u l-bank tal-klijent. Ir-rifużjonijiet tal-karti ta' kreditu tipikament jieħdu 5-10 ijiem ta' negozju.
Iċċekkja l-Ammont li Jista' Jiġi Rrrifondat
Qabel ma toħroġ rifużjoni parzjali, tista' tiċċekkja kemm hemm disponibbli:
curl -u YOUR_API_KEY: \
"https://api.costplus.online/v1/orders/{order_id}/?fields[]=amount_details"Il-qasam refundable fir-risposta juri l-ammont massimu li tista' tirrifondi.
Endpoints Relatati
- Oħloq Rifużjoni — oħroġ rifużjoni sħiħa jew parzjali fuq ordni kompluta
- Lista ta' Rifużjonijiet — iġbed ir-rifużjonijiet kollha għal ordni