Buckaroo Support - EN

Push messages

Each transaction status change can be communicated to the Merchant’s webshop system or other backoffice system by way of a push message. This message will be sent after the customer has completed the payment process and the bank or third-party payment processor has communicated the status to Buckaroo. It is however not always possible to communicate the definitive status of a transaction straight after the payment process has been completed. It is also possible that the status doesn’t end up in the normal payment process flow due to the fact that the consumer interrupted the payment process. In such cases, a push message can be used to communicate the transaction status. As soon as the status is known to Buckaroo, the push will automatically share this information with the webshop.

If the push fails, for example because the webshop system was temporarily not able to receive push messages, then the Buckaroo system will automatically make further attempts to send the push message. If the push messages still haven’t been received properly by the Merchant’s website after three days, Buckaroo will stop sending push messages.

Important: It is possible that a successful push message is performed more than once. Bear this in mind while processing the push message and do not automatically create a new order after each successful push.

Failed PUSH

The push service will try to connect to the set PUSH URL. This will probably be a script on your webshop. Or a regular page that can be opened in the browser. The push is considered successful after receiving a HTTP 200. When an error code appears after having tried to connect to the URL, the push service will interpret this as a push failure. Subsequently, a warning email can be sent to a specified email address. The push message will be sent once again at a later time. If, after a few attempts, the message still hasn’t been sent successfully, a concluding message can be sent. After that, no further attempts will be made to send the push. It is however still possible to send a push manually. For details, see the manual push. You can find a list of HTTP status codes on Wikipedia.

Push message repeats

If the push messages fail to be successful, new attempts will be made to send them. This might happen when a push notification wasn’t accepted or when the so-called listener wasn’t active. The push notification will be repeated with the following frequency: 5 minutes + 10 minutes + 15 minutes + 30 minutes + 1 hour + 2 hours + 4 hours + 8 hours + 8 hours + 24 hours + 24 hours. So that’s 11 attempts in total. With regard to the warning message following the first push fail and the concluding message following the final push, an email can be created in the Plaza.

Double PUSH

A push could be performed twice or even more for a variety of reasons. This situation may occur because a consumer is clicking back and forth between the different payment screens. It is also possible that while executing the push, the push server doesn’t receive the correct answer from the webshop and therefore will make another attempt to send the push at a later time. So please bear in mind that your system can receive a push message more than once. The push timestamp however allows you to make a clear distinction between the different messages regarding the same transaction. So that you’ll be able to place them in the correct time line without a problem.

PUSH order

Because a failed push will be resent again with a certain delay, it’s possible several push messages cross each other. Thus, it might occur that a push about the temporary pending status of a transaction is sent after the definitive successful or failed status has already been communicated.

To avoid making any mistakes, always check the accompanying timestamp. The status of a push message with an earlier timestamp can never overrule the status of a push message with a later timestamp.

Post push data
Element Description Optional?
brq_payment The Payment key. This value is only communicated if a payment method was selected because of the transaction. Yes
brq_payment_method The service code of the method used for the payment.  
brq_statuscode

The status code of the transaction.

No
brq_statuscode_detail

A detail status code which offers an additional explanation about the current status code.

Yes
brq_statusmessage A message about the status code. Yes
brq_invoicenumber The invoice number reported in the request. No
brq_amount_credit The credit amount as reported in the request, if it was indeed reported. Yes
brq_amount The amount reported in the request, if it was indeed reported. Yes
brq_currency The currency of the transaction (for example EUR, USD, GBP). No
brq_timestamp The time at which the payment received its current status: the timestamp. No
brq_service_[servicecode] _[parametername] Output parameters for the required services. Consult the service manual for a list of parameters. Yes
cust_[parametername] The predefined custom variables accompanying the original request. yes
add_[parametername] The additional parameters accompanying the original request. Yes
brq_transactions One or several transaction key(s). One key if one underlying transaction was created for the payment. Several keys if several underlying transactions are linked to the payment. No
brq_transaction_method The method used for the processing of the transaction (only when a transaction has already been processed). No
brq_transaction_type The transaction type code of the transaction (only when a transaction has already been processed). No
brq_mutationtype The mutation type of the transaction: collecting, processing , informational or not set. Yes
brq_signature The digital signature. No

 

IP addresses and port numbers

Push messages can be sent from the following IP addresses : 195.177.214.128/27

Sometimes test environments use other gateways to receive Buckaroo’s push messages. The following gateways are supported: 22; 44; 80; 8443; 8787; 8880; 8888.