theodenhollander/docdatapayments

PHP Docdata Payments is a (wrapper)class to communicate with Docdata Payments. Forked from Tijsverkoyen, extra feateres: up-to-date with api 1.2, logging interface and a determination whether an order is paid

3.1.1 2014-08-27 13:11 UTC

README

About

PHP Docdata Payments is a (wrapper)class to communicate with Docdata Payments. Forked from Tijsverkoyen, up-to-date with api 1.2, logging interface and a determination whether an order is paid

Extra

Forked from Tijsverkoyen Extra features:

Logging system

Interface to get extra information of the soap requests and responses

Api 1.2

Up-to-date with docdata

Class Paid Level

Docdata document: 733126_Integration_manual_Order_Api_1-1.pdf Chapter: 7.4 Determining whether an order is paid Determining whether an order is paid Different merchants can have different ways of determining when they consider an order “paid”, the totals in the status report are there to help make this decision. Keep in mind that the status report never reports about money actually having been transferred to a merchant, so it is not a complete guarantee that a payment has been finished in that sense. Using the totals to determine a level of confidence:

Quick Route:

 Another option is to see whether the sum of “total shopper pending”, “total acquirer pending”
 and “total acquirer authorized” matches the “total registered sum”.
 his implies that everyone responsible has indicated that they are going to make the payment
 and that the merchant is trusting that everyone will indeed make this.
 While this route will be faster, it does also have the risk that some payments
 will actually not have been made.

Balanced route: Depending on the merchant's situation, it can be a good option to only refer to certain totals.

 For instance, if the merchant only makes use of credit card payments it could be a good route to only look at
 “Total acquirer approved”, since this will be rather safe but quicker than looking at the captures.
 If the merchant does not want to rely on the supplied totals, they can of course also define their
 decision making on the actual authorization, capture and refund data which is also supplied in the
 status report and look at the payment method used.

Safe Route:

 The safest route to check whether all payments were made is for the merchants to refer to the
 “Total captured” amount to see whether this equals the “Total registered amount”.
  While this may be the safest indicator, the downside is that it can sometimes
  take a long time for acquirers or shoppers to actually have the money transferred and it can be captured.

License

PHP Docdata Payments is BSD licensed.

Documentation

The class is well documented inline. If you use a decent IDE you'll see that each method is documented with PHPDoc.