Notifications/bevestigingen zijn berichten die naar een script verzonden kunnen worden, waardoor uw server automatisch bericht krijgt zodra er een nieuwe order is geplaatst of als de status van een order is veranderd. Om onnodige vertragingen in het ordersysteem wegens timeouts te voorkomen, worden de notifications niet realtime verzonden, zij worden opgeslagen in een database en later verwerkt. De vertraging is onder normale omstandigheden niet meer dan 5 minuten.
Configuratie
Bezoek de 'Order Pages'afdeling in het Merchant Menu om deze optie in te schakelen. Klik op de link 'server notifications'. Het veld 'ExtraFields' kan gebruikt worden om toegestane orderpagina variabelen te posten (bijvoorbeeld cust_phone, user1, total_amount, etc...).
Specificatie
Request fields
Een notification bestaat uit een HTTP POST, welke de volgende velden bevat:
| Veld: |
Beschrijving: |
| order_num |
Ordernummer in 6.5 of 6.7 formaat |
| order_date |
Orderdatum en tijd |
| status |
Nieuww orderstatus, als volgt:
- accepted
- creditrequested
- credited
- retrieval
- chargeback
- declined
- suspended (de orderbevestigingsemail aan de klant is gebounced, er zijn enkele dagen om het emailadres van de klant aan te passen. Als dat niet gebeurt wordt de order gerefund, als dat wel gebeurt wordt de order alsnog geaccepteerd.)
- unknown (de order is batch processed (dit kan gebeuren als een realtime systeem de order niet kan verwerken), de status zal pas bekend zijn nadat de batch verwerkt is (meestal de volgende dag). Dus opnieuw zal de status verzonden worden via een tweede notification met een accpeted of declined status.)
- voided
- error
|
| reason |
Reden waarom de status veranderd is (tekst, niet specifiek gedetailleerd, alleen voor informatieve doeleinden). Voorbeelden:
New order created (bij status van de order, zie B en C waarom dit nodig is)
Order accepted (als een order batch processed was en later geaccepteerd is)
Order rejected
Order voided
Order credited
Rebilling accepted
Rebilling failed
|
| origin |
Herkomst van de order. Mogelijke waarden zijn order, rebill of manual |
| trans_type |
Transactie type. Mogelijke waarden zijn debit, credit of other |
| pageid |
PageID waar de order of rebilling vandaan komt. De waarde is de ID van uw orderpagina. Doo rhet toevoegen van deze waarde, kunt u optioneel hetzelfde notificationscript op uw server hebben voor al uw orderpagina's. |
| notifyid |
Onze interne unieke id voor deze notification. |
| created |
Datum + tijd in YYYY-MM-DD HH:MM:SS formaat wanneer de notification was aangemaakt. |
| ** |
Variabelen gebruikt tijdens het orderproces. Bijvoorbeeld: cust_email,cust_phone,total_amount_us,item1_qty. Voor een complete lijst van alle orderpagina variabelen, klik hier. Omdat de transactie al afgerond is kunt u ook total_amount en total_amount_us en order_num gebruiken als postfields. MultiCards can de variabelen voor u configureren. |
Response code
Uw script moet antwoorden met een 200 OK HTTP Status code, zodat onze handler wwet dat u script de notification heeft ontvangen. Post alstublieft geen grote hoeveelheden content terug. |