Transaction

It allows you to process transactions with or without token with the option to tokenize.

Production: https://api.payvalida.com/v4/merchant/transaccion

Sandbox: https://api-test.payvalida.com/v4/merchant/transaccion

Parameters in JSON format in the body of the POST request.

Parameters

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.

Request (without tokenize)

// Credit card transaction. It will not be tokenized.

{
	"merchantId": "my_merchant_name",
	"order": "1234567890",
	"checksum": "90037d4ae7d310c1c4c50ce630c54af850587533a900099cde381ac68aa8af1cc959b9820e77a48fb403c460a8630729bc37e2a9d47be9e3e846982fa7c56de0",
  "valor": 70500,
  "cuotas": 1,
  "tipoDI": "CC",
  "di": "1234567890",
  "cvv": 123,
  "numeroTarjeta": "53123456789083",
  "fechaExpiracion": "12/21",
  "nombreTitular": "John",
  "apellidosTitular": "Doe"
}

Request (tokenizing)

// Credit card transaction. It will be tokenized.

{
	"merchantId": "my_merchant_name",
	"order": "1234567890",
	"checksum": "90037d4ae7d310c1c4c50ce630c54af850587533a900099cde381ac68aa8af1cc959b9820e77a48fb403c460a8630729bc37e2a9d47be9e3e846982fa7c56de0",
  "valor": 70500,
  "cuotas": 1,
  "tipoDI": "CC",
  "di": "1234567890",
  "cvv": 123,
  "numeroTarjeta": "53123456789083",
  "fechaExpiracion": "12/21",
  "nombreTitular": "John",
  "apellidosTitular": "Doe",
  "tokenizar": true
}

Request (with token)

// Token transaction. The token was generated from a previously tokenized transaction with the credit card details. 

{
	"merchantId": "my_merchant_name",
	"order": "1234567890",
	"checksum": "90037d4ae7d310c1c4c50ce630c54af850587533a900099cde381ac68aa8af1cc959b9820e77a48fb403c460a8630729bc37e2a9d47be9e3e846982fa7c56de0",
  "valor": 70500,
  "cuotas": 1,
  "tipoDI": "CC",
  "di": "1234567890",
  "cvv": 123, // Required for franchises other than Mastercard
  "token": "12345678901234"
}

Response (example)

{
  "result": "200",
  "data": {
    "token": "5388846254108783",
    "order": {
      "amount": "44000.00",
      "date": "2020-09-30",
      "tax": "0",
      "total": "44000.00"
    },
    "transaction": {
      "date": "2020-10-01",
      "responseCode": "APROBADA",
      "installments": "1",
      "accountType": "CREDITO",
      "cus": "2020-10-01_112233",
      "invoiceNumber": "112233",
      "franchise": "MasterCard",
      "response": "Aprobado",
      "cardNumber": "************8783",
      "numAprobacion": "112233",
      "idTransaccionAutorizador": "332211"
    },
    "commerce": {
      "url": "https://www.payvalida.com",
      "terminal": "abcdef",
      "name": "VALIDDA S.A.S",
      "code": "73",
      "email": "[e-mail]",
      "net": "REDEBAN"
    },
    "user": {}
  },
  "error": ""
}

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.