• France
status page
Demo shops
assistance
FAQContact support
Search
Categories
Tags
docs.
France
Spain
Europe (English)
India
Homepage
Use cases
Create a payment
Create an installment payment
Create a multi-card (split) payment
Create a payment by Alias (Token)
Create a payment link
Create a recurring payment
Manage subscriptions
Manage your transactions (refund, cancel...)
Analyze your reports
API docs
Embedded Form
REST API
Hosted payment
Mobile payment
File exchange
SDD mandates by REST API
Snippets
Payment methods
Plugins
Marketplace
Guides
Merchant Back Office
Back Office Expert
Functional guides

Processing data specific to a PostFinance payment response

The Instant Payment Notification URL will contain the following information:

  1. Identify the payment result by retrieving the value of the vads_trans_status field.
    Value Description
    AUTHORISED

    The transaction has been accepted and will be automatically captured at the bank on the expected date.

    CAPTURED

    Captured

    The transaction has been captured by the bank.

    CANCELLED

    Canceled

    Cancellation by the buyer, the acquirer or the payment gateway.

    REFUSED

    Declined

    ABANDONED

    Payment abandoned by the buyer

    The transaction was not created, and is therefore not visible in the Expert Back Office.

  2. Identify the authorization mode by retrieving the value of vads_auth_mode
    Field name Description Value
    vads_auth_mode Authorization mode Only the FULL value is possible.

    Authorization for the total amount of the transaction.

    Value used for immediate payments if the period between the requested capture date and the current date is strictly shorter than the authorization validity period.

  3. Save the amount and the used currency. To do this, retrieve the values of the following fields:
    Table 1. Fields for analyzing the payment amount and currency
    Field name Description
    vads_amount Payment amount in the smallest currency unit.
    vads_currency Code of the currency used for the payment.
  4. Save the value of the vads_result field to obtain the transaction status.
    The possible values are presented in the following table. They are always the same regardless of the payment method. In case of a failure, you can also check the value of vads_auth_result to obtain additional information on the reason of the failure.
    Value Description
    00 Action successfully completed.
    02 The merchant must contact the cardholder’s bank. (Deprecated)
    05 Action rejected.
    17 Action canceled by the buyer.
    30 Request format error. To be associated with the value of the vads_extra_result field.
    96 Technical error.
  5. Retrieve the value of vads_presentation_date to know the date of capture at the bank.
    Field name Description Value
    vads_presentation_date Date of capture in the bank

    A PostFinance transaction is always presented on D+1.

  6. Retrieve the value of vads_payment_config to know the type of payment possible.
    Field name Description Value
    vads_payment_config Payment type SINGLE.
  7. Store the type of the card used for the payment by retrieving the value of the vads_card_brand field.
    The possible values:
    • POSTFINANCE
      PostFinance Card
    • POSTFINANCE_EFIN
      PostFinance e-finance
  8. Record the number of the contract associated with the transaction by retrieving the value of the vads_contract_used field.

Note

To see the result of the authorization request, save the value of the vads_auth_result field.

This value is returned and provided for information purposes and depends exclusively on the payment method.

This information is also available in your Expert Back Office. To see these details, view the details of a transaction. Among the information related to the authorization, the return details are displayed (code and reference).

The complete list of returned codes can be found in the table below. You can contact the support team for more details.

Field name Description Value
vads_auth_result Authorization request return codes The possible values are:
  • 00: accepted authorization
  • 101: invalid format
  • 102: withdrawal limit exceeded
  • 103: unknown merchant identifier
  • 104: transaction refused by the merchant
  • 105: unknown PSP identifier
  • 106: transaction refused by PSP
  • 107: a transaction with this identifier already exists
  • 108: authorization refused for unknown reason
  • 109: acquirer unavailable
  • 110: timeout issue on the acquirer’s side
  • 111: a technical problem occurred
  • 112: acquirer temporarily unavailable, try again
  • 113: transaction cancellation already in progress, it is impossible to go back
  • 114: timeout issue on the PSP side
Jobs
Legal
GDPR
25.22-1.11