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 |
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 ➡️