Direct Debits

When direct debits transactions are executed we send additional exchange calls to the configured exchange location.

ActionMoment
incassoaddDirectly after Pay received the mandate/direct debit and processes it to a bank order
incassosendDirectly after the direct debit request is sent to the bank
incassopendingWhen a direct debit has changed from status (e.g. the direct debit has been placed in a batch to be sent to the bank).
incassocollectedDirectly after the debited amount has arrived on Pay's. account; it is then also available on your balance. Note; also the new_ppt exchange call is sent when this action is sent.
incassostornoDirectly after the debited amount is declined and reversed from our account. This can occur up to 56 calendar days after received the incassocollected

An incasso exchange call has the following layout (depending on the exchange method configured).

{
   "action": "incassoadd",
   "pincode": "",
   "website_location_id": "1",
   "website_id": "1",
   "program_id": "202521",
   "promotor_id": "",
   "tool": "tool",
   "info": "info",
   "object": "object",
   "domain_id": "0",
   "ip_address": "10.11.12.13",
   "amount": "12.50",
   "extra1": "",
   "extra2": "",
   "extra3": "",
   "secret": "",
   "enduser_id": "0",
   "payment_session_id": "00000000000X0000",
   "payment_profile_id": "10",
   "product_id": "",
   "payment_method_id": "4",
   "order_id": "50101000003X34f0",
   "incasso_id": "30749455",
   "mandateId": "IO-1234-1234-1234",
   "referenceId": "IL-1234-1234-1234"
}

The actual status of a direct debit transaction or the mandate can be retrieved by calling the DirectDebit:Get endpoint with the referenceId (thus the IL- code) or the Mandate:Get endpoint with the mandateId (thus the IO- code).