Transaction
It allows you to process transactions with or without token with the option to tokenize.
Parameters in JSON format in the body of the POST request.
Campo | Requerido | Tipo | Descripción |
merchantId | yes | Alphanumeric | Name of the merchant. |
order | yes | Alphanumeric | Identification of the order previously created by the merchant. It is the code assigned by the merchant, not by Payvalida. |
checksum | yes | Alphanumeric | Checksum formed as follows: SHA512(merchantId + order + fixed_hash) |
valor | yes | numeric | Payment Amount. It must correspond to the one registered in the order at its creation time. |
cvv | yes | numeric | Credit card security code. This parameter must be sent the first time a transaction is made with the credit card. It is optional to send it in the subsequent transactions for the MasterCard franchise. If this parameter is sent, then it will be used. Otherwise, the transaction will be processed as a recurring. |
fechaExpiracion | yes | Alphanumeric | Credit card expiration date in MM/AA format. This parameter is required when the transaction is not by token. Otherwise, it will be ignored. In the last case the stored credit card information of the token will be used. |
cuotas | yes | numeric | Number of installments in which the payment will be amortized. This field must be greater than or equal to one. |
tipoDI | yes | Alphabetical | Type of identification document of the payer. |
di | yes | Alphanumeric | Identification document number of the payer. |
token | no | Alphanumeric | Credit card token. This field must be used only when the credit card was previously tokenized. |
numeroTarjeta | no | Alphanumeric | Credit card number. This field is required if the transaction is without token. Otherwise, it will be ignored. In the last case the stored credit card information of the token will be used. |
nombreTitular | no | Alphanumeric | Name of the credit card holder. This field is required when the transaction is not with token. Otherwise, it will be ignored. In the last case the stored credit card information of the token will be used. |
apellidosTitular | no | Alphanumeric | Last name of the credit card holder. This field is required when the transaction is not with token. Otherwise, it will be ignored. In the last case the stored credit card information of the token will be used. |
franquicia | no | Alphabetical | Credit card franchise. If this field is omitted and the transaction is without token, then the franchise will be inferred from the credit card number. This field is ignored when the transaction is with token, in this case the stored credit card information of the token will be used. |
tokenizar | no | boolean | Indicate whether to tokenize the credit card or not. This parameter will be ignored if the transaction is made with token. |
correo | no | Alphanumeric | Payer's email. |
telefono | no | Alphanumeric | Payer's phone number. |
ip | yes | Alphanumeric | IP address of the origin device of the end user. |
Warning: The contents of parameter token have priority over the rest of the parameters related to credit card data; in case a transaction with token is received, the parameters not associated to the token (franchise, card number, cardholder name, cardholder last name) will be ignored
The result code 200 indicates that the transaction was sent to the bank's processor, but it does not necessarily mean that it was approved. To verify if transaction was successful verify the field data.transaction.responseCode == "APROBADA". In case it is tokenized, the token is responded in the field data.token. In case of error the API will respond with the error message in the field error.
Última actualización