Skip to main content
Skip table of contents

Authorization Form Input Parameters

The following parameters are available for use in the Tokenization Form payload.

Parameter

Type

Long.

Description

Req.

action

String

(AN)

-

The intent of the merchant. In this case it is "authorize".

Yes

transaction.currency

String

(AN)

3

Numeric currency code in ISO 4217 format.

Yes

transaction.amount

String

(N)

15

Amount of the transaction in cents of currency, taking into account that we consider the last 5 positions as the decimal part of the amount.

Yes

transaction.meta.internal_operation_number

String

(N)

9

The customer's internal transaction number. This can be the order number or another number that the customer considers important.

Yes

transaction.meta.description

String

(AN)

50

Description of the transaction.

No

transaction.meta.additional_fields

String

(AN)

-

In this object are inserted fields that the customer believes to be important. These fields are determined and configured by the customer.

No

address.shipping.first_name

String

(AN)

50

Shipping First Name.

No

address.shipping.last_name

String

(AN)

50

Shipping Last Name.

No

address.shipping.email

String

(AN)

60

Shipping Email.

No

address.shipping.phone.country_code

String

(AN)

5

Shipping Country Code.

No

address.shipping.phone.subscriber

String

(AN)

20

Shipping Phone Number.

No

address.shipping.location.line_1

String

(AN)

50

Shipping Adress Line 1.

No

address.shipping.location.line_2

String

(AN)

50

Shipping Adress Line 2.

No

address.shipping.location.city

String

(AN)

30

Shipping City.

No

address.shipping.location.state

String

(AN)

30

Shipping State.

No

address.shipping.location.country

String (AN)

2

Shipping ISO country code.

No

address.shipping.location.zip_code

String

(AN)

10

Shipping Zip Code.

No

address.billing.first_name

String

(AN)

50

Billing First Name.

Yes

address.billing.last_name

String

(AN)

50

Billing Last Name.

Yes

address.billing.email

String

(AN)

60

Billing Email.

Yes

address.billing.phone.country_code

String

(AN)

5

Billing Country Code.

Yes

address.billing.phone.subscriber

String

(AN)

20

Billing Phone.

Yes

address.billing.location.line_1

String

(AN)

50

Billing Adress Line 1.

Yes

address.billing.location.line_2

String

(AN)

50

Billing Adress Line 2.

Yes

address.billing.location.city

String

(AN)

30

Billing City.

Yes

address.billing.location.state

String

(AN)

30

Billing State.

Yes

address.billing.location.country

String (AN)

2

Billing ISO Country Code.

Yes

address.billing.location.zip_code

String

(AN)

10

Billing Zip Code.

Yes

card_holder.first_name

String

(AN)

50

Cardholder's name.

Yes

card_holder.last_name

String

(AN)

50

Cardholder's last name.

Yes

card_holder.email_address

String

(AN)

60

Cardholder's email.

Yes

card_holder.identity_document_country

String

(AN)

50

Cardholder's ID country.

Yes

card_holder.identity_document_type

String

(AN)

30

Cardholder's ID type.

Yes

card_holder.identity_document_identifier

String

(AN)

20

Cardholder's ID number.

Yes

CODE
var payRequest = {
    "action": "authorize",
    "transaction": {
        "currency": "604",
        "amount": "100000",
        "meta": {
            "internal_operation_number": "000001",
            "description": "Descripcion de la transaccion",
            "additional_fields": { "reserverd1": "Prueba valor reservado 1" }
        }
    },
    "address": {
        "billing": {
            "first_name": "Juan",
            "last_name": "Perez",
            "email": "juan.perez@email.com",
            "phone": { "country_code": "51", "subscriber": "987654321" },
            "location": {
                "line_1": "Mi casa",
                "line_2": "Mi casa",
                "city": "LIMA",
                "state": "LIMA",
                "country": "PE",
                "zip_code": "18"
            }
        },
        "shipping": { ... }
    },
    "card_holder": [  {
            "first_name": "Juan",
            "last_name": "Perez",
            "email_address": "juan.perez@email.com",
            "identity_document_country": "PE",
            "identity_document_type": "DNI",
            "identity_document_identifier": "87654321"
        }
    ]
};

Continue to Authorization Form Output Parameters ➡️  

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.