Skip to main content

Create a payment redirection link for Services

POST 
/EPGCheckout/rest/online/tokenize - Quix Integration - Service
Create a payment redirection link for Services

Query Parameters

  • merchantId string required

    Your merchant identifier on the Addon Payments platform.

    Example: 123456
  • encrypted string required
    • Encryption of clear query parameters.
    • The final data sent will be in base64 format.
    • For the object, see Request Body
    Example: yGbFUz+X9hDK/R39QFRpckGojl/vSCJPCETpxxwPTXw+q+NQMeHUQDbj7OJYy6ZsKE+sbQIedQ36YUc8yKt7/aOU5xyyFamFaUM5MzU4oOAPNwBEkeBrbGdb0uwyJEJObij0tao1+r5XSCLBKGd1FM8pAhROaGJ8SqdFFWlgx2x9zvhtARDdU79AUPK79uAu9h34PK8eJCpPzLD2jRX7EruCtHeDjuPPZWUo2yhAMO33cKmTv8pGOGnFr0U+KbacbZZMZk2l0X+KADpKOLVFMvLJAOKR7kpqNXcqQulgaU8VtlXizk4bj6Gc/EilVcfyb7Ibyb9AO2hO3VvUk6/b9yCzIE4kIaKnKTmi5QuBKbR9zPDnPgjstMNZgpa9iY5XWxPR+FQA3DGgprnMUxwB6b6y5YQz7Z3Y4TBsjDTSb/2kl/pGBwx0C8kFleLcBZQbr7dgLO3OxAO+RnMOrU4SdTjKTJ9XcWeLsVlw0Ti7a625lpsFTej/q279KyEcoPmJaQnraXbm+ERM8hz5nPeQzvmmyXSnNB5noWbhAQGOnZVqopor9c14rH1NCasAyqgq7auzk39WdVlVCXKvQ01MIerjfr7jQhKHrnQ9Nz/T0hpbxMGxxsMLzjIe5xAz8VfCfwUaS96wQLqU+NCV9PBY79fH55rUPChEFZaQoFzOema6UEC+qvYScceiGtU15Abr+yjGCnAvHjpbdJykwTgEcWcNjOvntuLrpkTrnc/4L5VYyqvW2SUfQ7UKpfuEIoy4KU54dih1jM3MCIhh/vGrqBUsi2mmJUxrkkREkKrCR36CI6I0zv/sp2l7htzB3f8v1wq6rMCyo6a2yLSpHXSdk9jcEkwUbfEhb5SAsbTIw/Hpumr8POkXHiENx9ntg7htB8j4ON7ubnG5Qb93ktWI8uPuSQDf/+rCMii33YI2yjS59w/z5I40FG40lVDwgU0H1xSFiLbICFda78oQCOXHiFcTLlL7joV1JTHiwBYa5gz2Cwkm6toLZkVLW6O6ZmFtMMu++VjIcyeJaA+IssCpptSQq5mtq/tzLb2UzER0xSGRLzX0lVIi21P31KaVws4dX1rrx3McAoJArsrITamPI8kN+hzmgaErpQfwH994ivNBT/1jUlOvs6CXvEawU5vrCegp1ayofYeeyIo7JIvbjPfI6C58KJMxwHr+IWbTOFY+GErQxo3k5UTBmSICmkekzcgToaxzKYS6v/55VPJpNCl5lBNLoyj6u67jsQooYgkInnaYBidEW8Tc/mryz07P
  • integrityCheck string required
    • Sha256 of the clear query parameters in UTF_8 bytes.
    • Sent in lowercase hexadecimal form.
    Example: c4ca128afe39a4e2c5c3c529813f536d0265b5b90f30eeb3278236406d67db7c

Header Parameters

  • apiVersion string required

    AP API version through which the request must be processed.

    • Accepted values are 3, 4, and 5 (recommended)
    Example: 5
  • encryptionMode string required

    AES-256 encryption type used (CBC)

    Example: CBC
  • iv string required

    Initial vector used in the encryption process in Base64 Format

    Example: gH9j/x+Qu7M2r2SYPfa3UA==

Body

-- DO NOT SEND THIS REQUEST BODY, IT IS ONLY FOR DESCRIPTION -- This is the object used in the "encrypted" field
    merchantId Integer numeric 4~7 digitsrequired

    Identifier of your business on the AP platform.

    • It is a numeric code provided by Support in the welcome email
    • It has 4 to 7 digits and is common for both environments (test/production).
    merchantTransactionId Alphanumeric Max 45 charactersrequired

    Transaction identifier in your trading platform electronic. It is used for your platform to link the notifications received with the customer's order.

    • It cannot be repeated between transactions.
    • Max. 45 characters - Latin-1 code page (ISO-8859-1)
    amount Decimal numeric 0~1000000.00required

    Amount of the transaction.

    • If the amount contains decimals, the period (.) is used as the decimal separator.
    • You cannot include a thousands separator.
    • In transactions that do not generate monetary movement, such as the registration of a customer's card, zero (0) must be sent as the amount.
    • For example, €1,234.56 would be sent 1234.56
    currency Currencyrequired

    Possible values: [EUR, AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHF, CLF, CLP, CNH, CNY, COP, CRC, CUC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, FJD, FKP, GBP, GEL, GGP, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, IMP, INR, IQD, IRR, ISK, JEP, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MRU, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SSP, STD, STN, SVC, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VEF, VES, VND, VUV, WST, XAF, XAG, XAU, XCD, XDR, XOF, XPD, XPF, XPT, YER, ZAR, ZMW, ZWL]

    Currency of the transaction.

    • ISO-4217.3 code (EUR, USD, GBP, etc.).
    country stringrequired

    Country from which the transaction is sent.

    • ISO 3166-1 alpha-2 code (ES, US, UK, etc.).
    paymentSolution stringrequired

    Name of the payment solution through which the transaction must be processed (creditcards, bizum, paypal, quix, etc.).

    • Mandatory in the following cases:
      • If the cashier type “Only form” has been selected.
      • If you want to limit the customer to the payment solution sent.
    customerId Alphanumeric Max 80 charactersrequired

    ID. of the customer in your e-commerce platform.

    • Alphanumeric – Max. 80 characters.
    operationType stringrequired

    Possible values: [DEBIT, CREDIT]

    Specifies the type of operation to perform.

    • If the parameter is not sent, "debit" will be used by default.
    • Possible values are:
      • debit: payment transaction, that is, cash travels from the customer's account to the merchant.
      • credit: deposit transaction in the client's account, that is, the cash travels from the merchant to the client'saccount, such as the payment of a prize. Not to be confused with returns, which have their own type of transaction.
    productId Integer numeric 6~11 digitsrequired

    Highly Recommended identifier of the product created in your business in AP for which it must be processed the transaction.

    • It is provided in the welcome email.
    • Has 6 to 11 numerical digits.
    • The product is the one that limits which payment solutions of those activated for commerce are offer to the customer.
    • AP allows businesses to have various products configured to their needs.
    • If it is not sent, AP will use the first product from the business that is marked in the DB as "default"
    • If the merchant does not have any product marked "default" and the parameter is not sent, the request will fail.
      • It can be different depending on the environment (test and production).
    • For example:
      • A business has the card, Bizum and Quix payment solutions activated.
      • The business has two products, one for national customers with all payment solutions activated, and another for international customers with only card payment.
      • The merchant indicates the identifier of one or another product in the request depending on the nationality of your client
      • With this, it avoids offering payment solutions such as Bizum or Quix, which can only operate with national clients, to international clients.
    language string

    Possible values: [ES, EN]

    language in which the payment gateway must be displayed to the customer.

    • Only for hosted integration.
    • The following languages are currently available:
      • ES: Spanish
      • EN: English
    statusURL Alphabetical ISO 639-1required

    Highly Recommended URL of your e-commerce platform where AP will send the notification with the status of the transaction.

    • If it is sent in the request, it will have priority over the one configured in the Addon Payments administration panel.
    • Alphanumeric – Max. 2048 characters.
    successURL Alphabetical ISO 639-1required

    Highly Recommended Return URL to the merchant's website to which the customer will be redirected if the transaction is authorized.

    • Alphanumeric – Max. 2048 characters.
    • If it is sent in the request, it will have priority over the one configured in the Addon Payments administration panel.
    • If it is not sent in the request, the client will be redirected to the URL configured in the module administration.
    errorURL Alphabetical ISO 639-1required

    Highly Recommended Return URL to the merchant's website to which to redirect the customer if the transaction is denied.

    • Alphanumeric – Max. 2048 characters.
    • If it is sent in the request, it will have priority over the one configured in the Addon Payments administration panel.
    • If it is not sent in the request, the client will be redirected to the URL configured in the module administration.
    cancelURL Alphabetical ISO 639-1required

    Highly Recommended Return URL to the merchant's website to which the customer will be redirected if they cancel the transaction.

    • Alphanumeric – Max. 2048 characters.
    • If it is sent in the request, it will have priority over the one configured in the Addon Payments administration panel.
    • If it is not sent in the request, the client will be redirected to the URL configured in the module administration.
    awaitingURL Alphabetical ISO 639-1required

    URL of your platform to which the customer is redirected if the payment solution has to carry out internal procedures that may take time.

    type string

    Possible values: [MOTO, ECOM]

    Channel through which the transaction must be managed.

    • Possible values are:
      • ecom: electronic commerce.
      • moto: order by phone or email.
    paymentMethod string

    Sub-method of the payment solution.

    • There are payment solutions that concentrate other payment solutions.
      • The payment solutions that are contained within another superior one are known as methods.
      • To manage a transaction for a payment solution contained within another, it will be necessary to indicate the name of the payment solution contained in this parameter, and the name of the container payment solution in “paymentSolution”.
      • Example: the “Trustly” payment solution is contained within the “Ppro” payment solution, therefore, to send a transaction to it, the request should incorporate the following parameters:
        • paymentSolution = ppro
        • paymentMethod = trustly
    • Alphanumeric – Max. 45 characters.
    merchantParams Clave1:Valor1;Clave2:Valor2;ClaveN:ValorN Max. 500 characters

    Parameters that your electronic commerce platform sends to modify the management of the transaction in AP.

    • The parameters that are sent will be received back in the response.
    description Alphanumeric Max. 1000 characters

    Description of the transaction.

    • It can be useful to locate or identify it later in the AP management panel.
    firstName Alphabetical Maximum 100 charactersrequired

    First name.

    • Alphabetic - Max. 100 characters.
    • If there is more than one (1), they are separated by spaces.
    lastName Alphabetical Maximum 100 charactersrequired

    Last name(s).

    • Alphabetic - Max. 100 characters.
    • If there is more than one (1), they are separated by spaces.
    customerEmail Alphabetical Maximum 100 charactersrequired

    Email address.

    • Alphanumeric - Max. 100 characters.
    telephone Alphanumeric Maximum 45 characters

    Telephone number. Should not include the international prefix.

    • Numeric - Max. 45 characters.
    customerCountry stringrequired

    Possible values: [ES]

    Country of the customer.

    customerNationalId Alphanumeric Maximum 100 charactersrequired

    Identifier of the national identity document.

    • Alphanumeric - Max. 100 characters.
    • DNI number (with letter) in the case of Spanish customers.
    ipAddress IPv4 or IPv6 formatrequired

    Customer's IP address.

    • Alphanumeric - Max. 45 characters.
    • Format: IPv4 or IPv6
    dob DD-MM-AAAArequired

    Client's date of birth.

    paysolExtendedData objectrequired
    Extended data for Paysol specific to a product, including billing details and cart items for digital services.
    product stringrequired

    Product type, for example, 'installments'.

    billing objectrequired
    Billing information.
    first_name string

    First name for billing.

    last_name string

    Last name for billing.

    address object
    Billing address.
    street_address string

    Street address for billing.

    postal_code string

    Postal code for billing.

    city string

    City for billing.

    country string

    Country code for billing in ISO format.

    cart objectrequired
    Cart details for digital services.
    currency stringrequired

    Currency of the total cart.

    total_price_with_tax floatrequired

    Total cart price including taxes.

    items object[]required
    List of items in the cart.
  • Array [
    • article objectrequired
    Item details for digital service.
    name stringrequired

    Name of the digital service.

    type stringrequired

    Item type, for example, 'service'.

    category stringrequired

    Item category, for example, 'digital'.

    reference stringrequired

    Reference identifier for the item.

    unit_price_with_tax floatrequired

    Item unit price including taxes.

    start_date date-timerequired

    Start date of service availability.

    end_date date-timerequired

    End date of service availability.

    units integerrequired

    Number of units of the item.

    total_price_with_tax floatrequired

    Total price of the item including taxes.

    auto_shipping booleanrequired

    Indicates if automatic shipping applies to the item.

  • ]
    • disableFormEdition boolean

    allows to block the fields informed in the request (from the merchant), so that they cannot be edited in by the customer in UI

Responses
Redirection link created
Schema
    string
Loading...