Autorizar PayIn con Tarjeta eCommerce

Este servicio tiene como función permitir realizar una Autorización, tanto con Token como enviando los datos de la Tarjeta.

Si se desea autorizar con un Token se deberá previamente Crear Token de Tarjeta. De lo contrario se puede autorizar enviando los datos de la Tarjeta del Ejemplo 3.

Ambiente	EndPoint	Método
Desarrollo	https://api.dev.alignet.io/charges	POST
Producción	https://api.alignet.io/charges	POST

Headers

Cabecera	Valor	Requerido
Content-Type	application/json	SI
Authorization	Bearer <Access_Token>	SI

CODE

"Content-Type":"application/json",
"Authorization":"Bearer yJhbGciOiJSUzI1NsInR5cCI6IkpXVCIsImt………",

Request

Parámetro	Tipo	Long.	Descripción	Req.
action	Cadena (AN)	-	La intención del comercio. En este caso es "authorize"	SI
channel	Cadena (N)	3	El canal del cual proviene la petición. En este caso: 1 = eCommerce (“Card” o “Token + CVV”) 3 = Card on File (solo “Token”)	SI
payment_method.token.id	Cadena (AN)	25	El identificador del token que se quiere utilizar. No es obligatorio en caso se envié el objeto “Card”	SI
payment_method.token.security_code	Cadena (AN)	4	Código de seguridad de la tarjeta asociada al Token. Solo es Obligatorio en caso que Channel sea 1.	-
payment_method.card.pan	Cadena (N)	20	Numero de la tarjeta. No es obligatorio en caso se envié el objeto “Token”.	-
payment_method.card.expiry_date	Cadena (N)	4	Fecha de expiración de la tarjeta, en formato MMYY. No es obligatorio en caso se envié el objeto “Token”.	-
payment_method.card.security_code	Cadena (N)	4	Código de seguridad de la tarjeta. En caso que Channel sea 3 enviar 000. No es obligatorio en caso se envié el objeto “Token”.	-
transaction.currency	Cadena (AN)	3	Código numérico de moneda en formato ISO 4217	SI
transaction.amount	Cadena (N)	15	Monto de la transacción en centavos de moneda, tomando en cuenta que consideramos las 5 últimas posiciones como la parte decimal del monto.	SI
transaction.meta.internal_operation_number	Cadena (N)	9	El número de operación interno del cliente. Este puede ser el número de pedido u otro que considere el cliente como importante.	SI
transaction.meta.description	Cadena (AN)	50	Descripción de la transacción.	NO
transaction.meta.additional_fields	Cadena (AN)	-	En este objeto se insertan campos que el cliente crea importantes. Estos campos son determinados y configurados por el cliente.	NO
transaction.meta.additional_fields.plan	Cadena (N)	5	Valor correspondiente al plan.	NO
transaction.meta.additional_fields.cuota	Cadena (N)	5	Valor correspondiente a la cuota	NO
address.shipping.id	Cadena (AN)	50	El id de un objeto dirección previamente retornado. Se genera un nuevo id de dirección a cada vez que se genera una nueva dirección.	NO
address.shipping.first_name	Cadena (AN)	50	El nombre asociado a la dirección	NO
address.shipping.last_name	Cadena (AN)	50	El apellido asociado a la dirección	NO
address.shipping.email	Cadena (AN)	60	El correo electrónico asociado a la dirección	NO
address.shipping.phone.country_code	Cadena (AN)	5	El código de país asociado al número de teléfono de la dirección	NO
address.shipping.phone.subscriber	Cadena (AN)	20	El número de teléfono asociado a la dirección	NO
address.shipping.location.line_1	Cadena (AN)	50	La parte principal de la dirección, asociado a la dirección	NO
address.shipping.location.line_2	Cadena (AN)	50	El complemento de información de la dirección, asociado a la dirección	NO
address.shipping.location.city	Cadena (AN)	30	La ciudad asociada a la dirección	NO
address.shipping.location.state	Cadena (AN)	30	El estado asociado a la dirección	NO
address.shipping.location.country	Cadena (AN)	2	El código ISO 3166-1 alfa-2 de país asociado a la dirección	NO
address.shipping.location.zip_code	Cadena (AN)	10	El código postal asociado a la dirección	NO
address.billing.id	Cadena (AN)	50	El id de un objeto dirección previamente retornado. Se genera un nuevo id de dirección a cada vez que se genera una nueva dirección.	NO
address.billing.first_name	Cadena (AN)	50	El nombre asociado a la dirección	SI
address.billing.last_name	Cadena (AN)	50	El apellido asociado a la dirección	SI
address.billing.email	Cadena (AN)	60	El correo electrónico asociado a la dirección	SI
address.billing.phone.country_code	Cadena (AN)	5	El código de país asociado al número de teléfono de la dirección	SI
address.billing.phone.subscriber	Cadena (AN)	20	El número de teléfono asociado a la dirección	SI
address.billing.location.line_1	Cadena (AN)	50	La parte principal de la dirección, asociado a la dirección	SI
address.billing.location.line_2	Cadena (AN)	50	El complemento de información de la dirección, asociado a la dirección	SI
address.billing.location.city	Cadena (AN)	30	La ciudad asociada a la dirección	SI
address.billing.location.state	Cadena (AN)	30	El estado asociado a la dirección	SI
address.billing.location.country	Cadena (AN)	2	El código ISO 3166-1 alfa-2 de país asociado a la dirección	SI
address.billing.location.zip_code	Cadena (AN)	10	El código postal asociado a la dirección	SI
card_holder.first_name	Cadena (AN)	50	Nombre del tarjetahabiente	Si
card_holder.last_name	Cadena (AN)	50	Apellido del tarjetahabiente	Si
card_holder.email_address	Cadena (AN)	60	Correo del tarjetahabiente	Si
card_holder.identity_document_country	Cadena (AN)	50	País del documento de identidad del tarjetahabiente	Si
card_holder.identity_document_type	Cadena (AN)	30	Tipo de documento de identidad del tarjetahabiente	Si
card_holder.identity_document_identifier	Cadena (AN)	20	Numero de documento de identidad del tarjetahabiente	Si

1️⃣ Ejemplo: Autorización con Channel 3 enviando solo Token (Card on File)

CODE

{
    "action": "authorize",
    "channel": "3",
    "payment_method": {
        "token": [ { "id": "822a-748e-3z9h-0051" } ]
    },
    "transaction": {
        "currency": "604",
        "amount": "1000000",
        "meta": {
            "internal_operation_number": "123456",
            "description": "Descripcion de la transaccion",
            "additional_fields": {
                "reserved1": "Ejemplo valor reservado 1",
                "2": "Ejemplo valor reservado 2",
                "plan": "00",
                "cuota": "005"
            }
        }
    },
    "address": {
        "billing": {
            "first_name": "Juan Diego",
            "last_name": "Perez Sanchez",
            "email": "juan.perez@gmail.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"
            }
        }
    },
    "card_holder": [
        {
            "first_name": "Juan Diego",
            "last_name": "Perez Sanchez",
            "email_address": "juan.perez@email.com",
            "identity_document_country": "PER",
            "identity_document_type": "DNI",
            "identity_document_identifier": "87654321"
        }
    ]
}

2️⃣ Ejemplo: Autorización con Channel 1 enviando Token más CVV (eCommerce)

CODE

{
   "action":"authorize",
   "channel":"1",
   "payment_method":{
      "token":[
         {
            "id":"822a-748e-3z9h-0051",
            "security_code":"123"
         }
      ]
   },
   "transaction":{
      "currency":"604",
      "amount":"1000000",
      "meta":{
         "internal_operation_number":"123456",
         "description":"Descripcion de la transaccion"
      }
   },
   "address":{
      "billing":{
         "first_name":"Juan Diego",
         "last_name":"Perez Sanchez",
         "email":"juan.perez@gmail.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"
         }
      }
   },
   "card_holder":[
      {
         "first_name":"Juan Diego",
         "last_name":"Perez Sanchez",
         "email_address":"juan.perez@email.com",
         "identity_document_country":"PER",
         "identity_document_type":"DNI",
         "identity_document_identifier":"87654321"
      }
   ]
}

3️⃣ Ejemplo: Autorización con Channel 1 enviando datos de la Tarjeta (eCommerce)

CODE

{ 
   "action":"authorize",
   "channel":"1",
   "payment_method":{ 
      "card":[ { 
            "pan":"4859510000000051",
            "expiry_date":"1220",
            "security_code":"365"
         } ]
   },
   "transaction":{ 
      "currency":"604",
      "amount":"1000000",
      "meta":{ 
         "internal_operation_number":"123456",
         "description":"Descripcion de la transaccion",
         "additional_fields":{ 
            "reserved1":"Ejemplo valor reservado 1",
            "2":"Ejemplo valor reservado 2",
            "plan":"00",
            "cuota":"005"
         }
      }
   },
   "address":{ 
      "billing":{ 
         "first_name":"Juan Diego",
         "last_name":"Perez Sanchez",
         "email":"juan.perez@gmail.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"
         }
      }
   },
   "card_holder":[ 
      { 
         "first_name":"Juan Diego",
         "last_name":"Perez Sanchez",
         "email_address":"juan.perez@email.com",
         "identity_document_country":"PER",
         "identity_document_type":"DNI",
         "identity_document_identifier":"87654321"
      }

Response

Parámetro	Descripción
action	Proceso realizado, en este caso es " authorize "
id	Identificador de la transacción asignado por Alignet.
success	True en caso que la petición sea satisfactoria o False en caso contrario.
transaction.currency	Código numérico de moneda en formato ISO 4217
transaction.amount	Monto de la transacción en centavos de moneda, tomando en cuenta que consideramos las 5 últimas posiciones como la parte decimal del monto.
transaction.meta.internal_operation_number	El número de operación interno del cliente. Este puede ser el número de pedido u otro que considere el cliente como importante.
transaction.meta.description	Descripción de la transacción.
transaction.meta.processor.authorization.code	Código de autorización de la procesadora
transaction.meta.additional_fields	En este objeto se devuelven los campos que el cliente definió. Estos campos son determinados y configurados por el cliente.
transaction.meta.status.code	Código asociado al estado de la operación
transaction.meta.status.message_ilgn.locale	Locale en la cual está escrito el mensaje.
transaction.meta.status.message_ilgn.value	Valor del mensaje textual
validations	En este objeto se devuelven los resultados de las validaciones realizadas.

CODE

{
    "action": "authorize",
    "id": "500114",
    "success": "true",
    "transaction": {
        "currency": "604",
        "amount": "1000000",
        "meta": {
            "internal_operation_number": "500114",
            "description": "Descripcion de la transaccion",
            "processor": {
                "authorization": {
                    "code": "191046"
                }
            },
            "additional_fields": {
                "2": "Ejemplo valor reservado 2",
                "reserved1": "Ejemplo valor reservado 1"
            },
            "status": {
                "code": "00",
                "message_ilgn": [
                    {
                        "locale": "es_PE",
                        "value": "Operacion Autorizada"
                    }
                ]
            }
        }
    },
    "validations": null,
    "token": null
}