Search

    Lyra Collect Documentation
    Menu
    • Home
    • Collect documentation
      • Embedded form
      • REST payment API
      • Hosted payment page documentation
      • Webservices implementation guide
      • File exchange payment
      • Mobile payment
      • Marketplace
      • Free payment plugins
      • Expert Back Office
      • Snippets
      • Test cards guide
      • FAQ
    • Support
    lyra.com
    • Europe (english)
      • France
    Menu

    Form payment

    • Implementation quick start guide
    • Hosted payment page
    • Iframe payment
    • Payment method
      • Bancontact
      • e-Chèque-Vacances (ANCV)
      • Conecs
      • Giropay
      • iDEAL
      • Multibanco
      • MyBank
      • Przelewy24
      • Sofort
      • UnionPay
    • eWallets
      • Alipay
      • Paylib
      • PayPal
      • WeChat Pay
    • Tokenization and subscriptions
    • Test cards guide
    • Error codes

    Hosted Payment Page

    Download PDF
    • History of the document
    • Obtaining help
    • Different types of payments
      • Immediate payment
      • Deferred payment
      • Installment payment
      • Authorization request
    • 3DS2: the new authentication standard
      • Implementation
      • “Frictionless” flow
      • “Challenge” flow
      • Increasing the chances of a frictionless payment
    • Understanding the payment flow
      • Defining the steps of the payment process - As seen by the buyer
      • Defining the steps of the payment process - As seen by the merchant
      • Transaction lifecycle
    • Establishing interaction with the payment gateway
      • Setting up the payment page URL
      • Identifying yourself when exchanging with the payment gateway
      • Choosing between Test and Production modes
      • Managing the interaction with the merchant website
      • Managing security
      • Managing shop settings via a configuration file
    • Setting up notifications
      • Notifications about the various statuses of an immediate payment
      • Notifications of the different statuses for a deferred payment
      • Notifications about the various statuses of installments
      • Setting up notifications
        • Setting up the Instant Payment Notification
        • Setting up notifications about the final result of a deferred payment
        • Setting up notifications in case of abandoned or canceled payments
        • Setting up a notification on batch change
      • Activating the automatic retry
      • Manual notification retry
      • Configuring e-mails sent to the buyer
      • Configuring e-mails sent to the merchant
    • Generating a payment form
      • Creating an immediate payment
      • Creating a deferred payment
      • Creating an installment payment
      • Creating an authorization without capture
    • Using additional features
      • Managing the return to the merchant website
      • Enabling an automatic return to the merchant website
      • Defining the capture mode (automatic/manual)
      • Transmitting buyer details
      • Transmitting shipping details
      • Transmitting order details
      • Enabling / Disabling 3D Secure 1
      • Transmitting merchant preferences
      • Overriding the IPN
      • Defining the Merchant ID (MID)
      • Creating specific fields according to your requirements
    • Submitting your transactions to a risk analyzer
      • Configuring Expert Back Office
      • List of fields to send
    • Customizing the elements of the payment page
      • Overriding the custom template
      • Managing the payment methods offered to the buyer
      • Selecting a different language
      • Modifying the languages available to the buyer
      • Modifying the name and the URL of the shop
      • Changing the name of the "Return to shop" button
    • Displaying the payment page in an iframe
    • Computing the signature
      • Example of implementation with JAVA
      • Example of implementation with PHP
    • Sending the payment request
      • Redirecting the buyer to the payment page
      • Processing errors
      • Managing timeouts
    • Analyzing the payment result
      • Retrieving data returned in the response
      • Computing the IPN signature
      • Comparing signatures
      • Analyzing the nature of the notification
      • Identifying the type of operation
      • Processing the response data
      • Processing errors
    • Returning to the shop
    • Testing the IPN
    • Data dictionary
      • Viewing parameters sorted by category
        • Technical details
        • Order details
        • Buyer details
        • Shipping details
        • Payment method details
        • Transaction details
        • 3DS Authentication
        • Customizing the payment page
        • Redirection to the merchant website
        • Recurring payment details
        • Risk analysis details
      • signature
      • vads_acquirer_transient_data
      • vads_action_mode
      • vads_amount
      • vads_auth_mode
      • vads_auth_number
      • vads_auth_result
      • vads_authent_paypal_protection_eligibility
      • vads_authent_nsu
      • vads_available_languages
      • vads_avs_result
      • vads_bank_code
      • vads_bank_label
      • vads_bank_product
      • vads_birth_day
      • vads_birth_month
      • vads_birth_year
      • vads_brand_management
      • vads_capture_delay
      • vads_card_brand
      • vads_card_country
      • vads_card_holder_name
      • vads_card_number
      • vads_change_rate
      • vads_contracts
      • vads_contract_used
      • vads_contrib
      • vads_ctx_mode
      • vads_currency
      • vads_cust_address
      • vads_cust_address2
      • vads_cust_address_number
      • vads_cust_cell_phone
      • vads_cust_city
      • vads_cust_country
      • vads_cust_district
      • vads_cust_email
      • vads_cust_first_name
      • vads_cust_id
      • vads_cust_last_name
      • vads_cust_legal_name
      • vads_cust_name
      • vads_cust_national_id
      • vads_cust_phone
      • vads_cust_state
      • vads_cust_status
      • vads_cust_title
      • vads_cust_zip
      • vads_effective_amount
      • vads_effective_creation_date
      • vads_effective_currency
      • vads_expiry_month
      • vads_expiry_year
      • vads_ext_info
      • vads_ext_info_bil_address_complement
      • vads_ext_info_bil_date_of_birth
      • vads_ext_info_bil_gender
      • vads_ext_info_deadline
      • vads_ext_info_fingerprint_id
      • vads_ext_info_ship_address_complement
      • vads_ext_info_ship_date_of_birth
      • vads_ext_info_ship_gender
      • vads_ext_info_soft_descriptor
      • vads_ext_trans_id
      • vads_extra_result
      • vads_first_installment_delay
      • vads_hash
      • vads_identifier
      • vads_identifier_status
      • vads_iframe_options
      • vads_insurance_amount
      • vads_language
      • vads_nb_products
      • vads_operation_type
      • vads_order_id
      • vads_order_info
      • vads_order_info2
      • vads_order_info3
      • vads_override_payment_cinematic
      • vads_page_action
      • vads_payment_cards
      • vads_payment_certificate
      • vads_payment_config
      • vads_payment_error
      • vads_payment_option_code
      • vads_payment_seq
      • vads_payment_src
      • vads_pays_ip
      • vads_presentation_date
      • vads_pretax_amount
      • vads_product_amountN
      • vads_product_ext_idN
      • vads_product_labelN
      • vads_product_qtyN
      • vads_product_refN
      • vads_product_typeN
      • vads_product_vatN
      • vads_proof_of_id_number
      • vads_proof_of_id_type
      • vads_recurrence_number
      • vads_recurrence_status
      • vads_redirect_error_message
      • vads_redirect_error_timeout
      • vads_redirect_success_message
      • vads_redirect_success_timeout
      • vads_requestor
      • vads_result
      • vads_return_mode
      • vads_risk_analysis_result
      • vads_risk_assessment_result
      • vads_risk_control
      • vads_sequence_number
      • vads_ship_to_city
      • vads_ship_to_country
      • vads_ship_to_delay
      • vads_ship_to_delivery_company_name
      • vads_ship_to_district
      • vads_ship_to_first_name
      • vads_ship_to_last_name
      • vads_ship_to_legal_name
      • vads_ship_to_name
      • vads_ship_to_phone_num
      • vads_ship_to_speed
      • vads_ship_to_status
      • vads_ship_to_state
      • vads_ship_to_street
      • vads_ship_to_street2
      • vads_ship_to_street_number
      • vads_ship_to_type
      • vads_ship_to_user_info
      • vads_ship_to_zip
      • vads_shipping_amount
      • vads_shop_name
      • vads_shop_url
      • vads_site_id
      • vads_subscription
      • vads_sub_amount
      • vads_sub_currency
      • vads_sub_desc
      • vads_sub_effect_date
      • vads_sub_init_amount
      • vads_sub_init_amount_number
      • vads_tax_amount
      • vads_tax_rate
      • vads_theme_config
      • vads_threeds_auth_type
      • vads_threeds_cavv
      • vads_threeds_cavvAlgorithm
      • vads_threeds_eci
      • vads_threeds_enrolled
      • vads_threeds_error_code
      • vads_threeds_exit_status
      • vads_threeds_mpi
      • vads_threeds_sign_valid
      • vads_threeds_status
      • vads_threeds_xid
      • vads_token_id
      • vads_totalamount_vat
      • vads_trans_date
      • vads_trans_id
      • vads_trans_status
      • vads_trans_uuid
      • vads_url_cancel
      • vads_url_check
      • vads_url_check_src
      • vads_url_error
      • vads_url_post_wallet
      • vads_url_referral
      • vads_url_refused
      • vads_url_return
      • vads_url_success
      • vads_user_info
      • vads_validation_mode
      • vads_version
      • vads_wallet
      • vads_warranty_result

    Managing the return to the merchant website

    At the end of payment, the buyer has the possibility to return to the merchant website via a return URL. This URL is called Return URL.

    It is not to be confused with Instant notification URL (IPN) (see chapter Managing the interaction with the merchant website).

    • Defining the Return URLs
    • Defining the method for receiving data
    We recruit
    PayZen Documentation

    Head Office :

    LYRA NETWORK
    109, rue de l’innovation
    31670 Labège
    FRANCE