Manage Unzer Direct Bank Transfer payment
Manage your Unzer Direct Bank Transfer payments.
Manage paymentsAfter the successful charge transaction, you can perform additional operations on the payment resource. Some of the important ones are described in the following section.
For a full reference of managing payments, go to relevant server-side integration documentation page: Manage API resources (direct API calls), Manage API resources (PHP SDK), or Manage API resources (Java SDK).
Get additional transaction data
You can get the payment details by using the getPayment call. This provides you with the payment status along with all the relevant data. For more information about the getPayment call, go to the API reference.
Within the transactions Array of the charge transaction, there is a specific section dedicated to the additional transaction data. This section contains important insights regarding the settlement status of the payment.
GET https://api.unzer.com/v1/payments/{paymentId}
...
transactions: [
...
{
"additionalTransactionData":
{
"onlineTransfer":
{"targetDueDate": "2025-01-24T08:12:35.633Z"}
}
}
]
| Field name | Description |
|---|---|
additionalTransactionData | When a payment is settled, the following structure is included into the response of the getpayment call. |
onlineTransfer | This key indicates that the payment was processed through an online transfer method. |
targetDueDate | This field specifies the date and time when the payment was credited to the Unzer bank account. The format follows the ISO 8601 standard, ensuring clarity and consistency. |
Please be aware that funds can only be transferred after the settlement date has been set. The settlement date acts as the trigger for the funds transfer at Unzer, and any subsequent transfers to the merchant’s bank account will occur after this date. To facilitate this process, you can request the settlement date by making a GET request.
Cancel after payment (refund)
Cancel after payment (refund)You can refund up to the amount of the received payment. To do this, you have to make a cancel transaction for an existing charge transaction.
POST https://api.unzer.com/v1/payments/s-pay-1/charges/s-chg-1/cancels
{
"amount" : "20.000",
"paymentReference": "Test cancel transaction"
}
$unzer = new Unzer('s-priv-xxxxxxxxxx');
$charge = $unzer->fetchChargeById('s-pay-1', 's-chg-1');
$cancel = $charge->cancel();
Unzer unzer = new Unzer("s-priv-xxxxxxxxxx");
Cancel cancel = unzer.cancelCharge("s-pay-1", "s-chg-1");