MultiCards START
affiliates privacy & missie sitemap
credit card processing  
start diensten prijzen aanmelden transactie info nieuws merchant login demo pagina f.a.q. contact
Support

 

Nieuwe order notification via een script

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.