• France
status page
demonstrations
assistance
FAQContact support
Search
Categories
Tags
English
French
English
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
Snippets
Payment methods
Plugins
Guides
Merchant Back Office
Functional guides

Processing the response data

Here is an example of analysis to guide you through processing the response data.

  1. Identify the order by retrieving the value of the vads_order_id field if you have transmitted it in the payment form.
    Make sure that the order status has not been updated yet.
  2. Retrieve the payment result transmitted in the vads_trans_status field.
    Its value allows you to define the order status.
    VALUE DESCRIPTION
    WAITING_AUTHORISATION

    Waiting for authorization

    Transaction waiting for authorization.

    This status is temporary.

    A transaction in this status will evolve into one of the following statuses:

    • ABANDONED
    • AUTHORISED
    • REFUSED

    This status does not allow cancellation.

     To know the final status of the transaction, you must activate the rule Instant Payment Notification URL on batch change.
    ABANDONED

    Abandoned

    Payment abandoned by the buyer

    The transaction is visible in the Merchant Back Office.

    REFUSED

    Refused

    The payment is declined.

    AUTHORISED

    Waiting for capture

    The credit request is accepted. The payment will be automatically captured in the bank.
    CAPTURED

    Captured

    The payment is captured in the bank. The fund transfer to the merchant’s account is complete.

    CANCELLED

    Canceled

    The payment was canceled by the merchant before it was captured in the bank.

  3. Retrieve the field vads_trans_uuid containing the transaction unique reference generated by the payment server.
  4. Retrieve the Franfinance payment reference in the vads_ext_trans_id field.
  5. Retrieve the value of the vads_trans_date field to identify the payment date.
  6. Retrieve the amount and currency. To do this, retrieve the values of the following fields:
    Field name Description
    vads_amount Payment amount in the smallest currency unit.
    vads_currency Numeric code of the currency used for the payment.
  7. Retrieve the payment method data used for the payment by analyzing the following fields:
    Field name Description
    vads_card_brand Used payment method Set to:
    • FRANFINANCE_3X: for a 3 installments payment.
    • FRANFINANCE_4X: for a 4 installments payment.
    vads_acquirer_network Acquirer network code. Populated with:
    • FRANFINANCE for a production payment
    • FRANFINANCE_SB for a test payment.
  8. Retrieve all the order, buyer and shipping details.
    These details will be provided in the response only if they have been transmitted in the payment request.
    Their values are identical to the ones submitted in the form.
  9. Proceed to order update.
© 2025 {'|'} All rights reserved to Sogecommerce
25.18-1.11