Integration

Integration


The payment flow is as follows: A consumer starts a transaction. The merchant will collect the required wallet information. The required information will be sent to Buckaroo and Buckaroo checks the balance on the Buckaroo Wallet. Buckaroo will check if the total amount that should be paid by the consumer is paid. A push will be sent to the merchant.

The deposit flow: The initiate increase is not part of this manual since the real transaction is not linked to the wallet. When a payment is received the initiate deposit can be used to increase the balance on the Buckaroo Wallet.

The servicecode for a wallet is: buckaroowallets

The following actions are supported:

Transaction requests

  • Refund: Refund the wallet payment Transaction
  • Deposit: The Deposit request is a transaction request that can be used to increase a wallet balance. Transaction data like AmountCredit and currency is required to specify the transaction.
  • Reserve: The Reserve request is a transaction request that can be used to increase the balance of a wallet, with the only difference that the reserved amount is not yet usable. The request is, apart from its action name, identical to the Deposit request.
  • Withdrawal: The Withdrawal request is a transaction request that can be used to decrease a Wallet's usable balance.
  • Cancel: The Cancel request is a transaction request that cancels a reserved amount. As a result, it will decrease the balance of the wallet.
  • Pay: The Pay request is a transaction request that can be used to spend an amount in the usable balance of the wallet.
  • Refund: The Refund request is a transaction request and can be used to perform a refund on a previously successful Wallet Pay transaction. This will increase the usable balance of the Wallet.

Data requests

  • Create: The Create request is a data request and is used to create a new wallet. It is possible to provide customer details but this is not required. Customer details can be added or updated at a later moment by the Update request. The WalletId must be unique, regardless of test or live. It is not possible to delete a wallet, but only to (de)activate it.
  • Update: The Update request is a data request that can be used to update information of a wallet, with the exception of the WalletId itself. Additionally, the Wallet status can be updated.
  • GetInfo: The GetInfo request is a data request that can be used to retrieve information of a Wallet.
  • Release: The Release request is a data request that can be used to make a reserved amount usable in the Buckaroo Wallet, so it can be used to perform mutations like payments and withdrawals.

Was this article helpful?

What's Next