API de Autorización - Tarjeta Presente
El API de Autorización permite generar una transacción dependiendo el método de pago que escoga.
REQUEST
Path
Method: POST
URL: {{base}}/charges
Headers
Para todos los métodos de pagos, se enviará los siguientes parámetros en la cabecera de la petición:
Field | Description | Accepted Value | Type |
|---|---|---|---|
| Token de identificación para uso del API creado previamente en API de Seguridad | Cadena alfanumérica |
|
Body
Se detalla el request que se usará para todos los métodos de pagos:
Field | Description | Accepted Value | Type | Obligatorio |
|---|---|---|---|---|
| Acción a ejecutar |
|
| |
| Canal donde se ejecutará la transacción |
|
| |
| Identificador del comercio | Cadena Alfanumérica |
| |
| Número asignado por la entidad para identificar de forma unívoca a la transacción | Cadena numérica |
| |
| Información del método de pago usado en la operación | - |
| |
| Nombre del método de pago que se usará para la autorización. |
|
| |
| - |
| ||
| Número de la tarjeta | Cadena numérica |
| |
| Fecha expiración de la tarjeta en el formato MMYY | Cadena numérica |
| |
| Código de proceso. Describe el efecto de la transacción en la cuenta del cliente y en el tipo de cuenta afectada. | Cadena numérica |
| |
| Bloque de PIN | Cadena alfanumérica |
| |
| Pista 2 | Cadena alfanumérica |
| |
| Modo de ingreso en el punto de venta. Códigos numéricos que indican el método usado para ingresar el PAN de la tarjeta y las capacidades de ingreso de PIN en el terminal. | Cadena numérica |
| |
| Número secuencial de la tarjeta. Códigos numéricos que indican el método usado para ingresar el PAN de la tarjeta y las capacidades de ingreso de PIN en el terminal. | Cadena numérica |
| |
| Código alfanumérico que identifica al punto de venta | Cadena alfanumérica |
| |
| Información relacionada a la tarjeta chip, trasmite información leída del chip al emisor e información del emisor al chip | - |
| |
|
| - |
| |
| Importe de la transacción | Cadena numérica |
| |
| Código de moneda | Cadena numérica |
|
{
"action": "authorize",
"channel": "POS",
"merchant_code": "87cd5d6d-ba64-42b1-b66a-18bf8f9bb342",
"merchant_operation_number": "8573772",
"payment_method": {
"method_name": "CARD",
"method_details": {
"pan": "4012002000019400",
"expiry_date": "1231",
"process_code": "000000",
"pin_block": "695D65F3779F0AE6",
"track_2": "4012002000019400D31122011637114000000",
"entry_mode": "0710",
"sequential_number": "001",
"card_acceptor_terminal_id":"20200186",
"icc_related_data": [
{
"tag": "9F02",
"is_hex": true,
"value": "000000010000"
},
{
"tag": "9F26",
"is_hex": true,
"value": "41A2E5B3EE47A7D6"
},
{
"tag": "9F33",
"is_hex": true,
"value": "E06848"
},
{
"tag": "9F10",
"is_hex": true,
"value": "06011203A00000"
},
{
"tag": "9F40",
"is_hex": true,
"value": "F000F0A001"
},
{
"tag": "9F34",
"is_hex": true,
"value": "000000"
},
{
"tag": "9F35",
"is_hex": true,
"value": "22"
},
{
"tag": "82",
"is_hex": true,
"value": "0000"
},
{
"tag": "9F36",
"is_hex": true,
"value": "0008"
},
{
"tag": "9F27",
"is_hex": true,
"value": "80"
},
{
"tag": "95",
"is_hex": true,
"value": "0000000000"
},
{
"tag": "9F37",
"is_hex": true,
"value": "EE39866B"
},
{
"tag": "9F1A",
"is_hex": true,
"value": "0604"
},
{
"tag": "5F2A",
"is_hex": true,
"value": "0604"
},
{
"tag": "9A",
"is_hex": true,
"value": "240731"
},
{
"tag": "9C",
"is_hex": true,
"value": "00"
},
{
"tag": "5F34",
"is_hex": true,
"value": "01"
},
{
"tag": "9F6E",
"is_hex": true,
"value": "20700000"
},
{
"tag": "9F1E",
"is_hex": true,
"value": "4341313336363833"
}
]
}
},
"payment_details": {
"amount": "10000",
"currency": "604"
}
}RESPONSE
Field | Description | Accepted Value | Type | Obligatorio |
|---|---|---|---|---|
| Determina si la trama fue procesada exitosamente por el orquestador | “true”, “false” |
| |
| Acción que se busca realizar | “authorize" |
| |
| Canal de captura de la operación, puede ser ecommerce, pos u otros a definir a futuro | “POS” |
| |
| Código de comercio | Cadena alfanumérica |
| |
| Número asignado por la entidad para identificar de forma unívoca a la transacción. | Cadena numérica |
| |
|
|
|
| |
| Identificador de la transacción | Cadena alfanumérica |
| |
| Estado de la transacción | Cadena alfanumérica |
| |
|
|
|
| |
| Importe de la transacción | Cadena numérica |
| |
| Código de moneda | Cadena numérica |
| |
| Objeto para adicionar datos a la tansacción |
|
| |
|
|
|
| |
| Campo que identifica método a usar | "CARD" |
| |
| Campo que hace referencia a demás campos o propiedades que se usen exclusivamente para el método especificado |
|
| |
|
|
|
| |
|
|
|
| |
|
|
|
| |
|
|
|
| |
|
|
|
| |
|
|
|
| |
|
|
|
| |
|
|
|
| |
|
|
|
| |
|
|
|
| |
|
|
|
| |
|
| - |
| |
| Fecha y hora en la que se realizó la autorización | Cadena alfanumérica |
| |
| Código de autorización entregado por la procesadora. | Cadena numérica |
| |
| Identificador único de la transacción | Cadena numérica |
| |
| Contiene un número que se usa para identificar y rastrear todos los mensajes relacionados con una determinada transacción por la marca. | Cadena numérica |
| |
|
|
|
| |
|
|
|
| |
|
|
|
| |
|
|
|
| |
|
|
|
| |
|
|
|
| |
| Objeto con información del resultado de la autorización | - |
| |
| Código del resultado de la autorización | Cadena numérica |
| |
| Descripción del resultado de la autorización | Cadena alfanumérica |
| |
|
|
|
| |
|
|
|
| |
|
|
|
| |
|
|
|
| |
|
|
|
| |
|
|
|
| |
|
| - |
| |
|
| - |
| |
|
| Cadena numérica |
| |
|
| - |
|
{
"success": "true",
"action": "authorize",
"channel": "POS",
"merchant_code": "87cd5d6d-ba64-42b1-b66a-18bf8f9bb342",
"merchant_operation_number": "8573772",
"transaction": {
"transaction_id": "d61zje9xlpbtf5euqp6jv9ttu",
"state": "AUTORIZADO",
"state_reason": "Pago exitoso",
"amount": "10000",
"currency": "604",
"additional_fields": null,
"payment_method": {
"method_name": "CARD",
"method_detail": {
"masked_pan": "401200******9400",
"brand": "VISA",
"bin": "401200",
"last_pan": "9400",
"card_type": "CREDIT",
"card_country": "US",
"issuer": null
}
},
"risk_evaluation": null,
"processor_response": {
"authorization_date": "08-08-2024 16:30:30",
"authorization_code": "012069",
"brand_transaction_identifier": "304221594291810",
"retrieval_reference_code": "422116018793",
"response_fields": {
"response_source_code": "V",
"address_verification_result_code":" ",
"issuer_authentication_data": "5BE9AFAF00860000",
"original_transaction_date_time": "0808163029"
},
"amount_of_installment": null,
"result_message": {
"code": "00",
"description": "Approval and completed successfully"
}
},
"lifecycle": [
{
"state": "REGISTRADO",
"date": {
"utc_time": "2024-08-08T16:30:12",
"unix_time": 1723134612.029
}
},
{
"state": "PENDIENTE",
"date": {
"utc_time": "2024-08-08T16:30:12",
"unix_time": 1723134612.285
}
},
{
"state": "AUTORIZADO",
"date": {
"utc_time": "2024-08-08T16:30:30",
"unix_time": 1723134630.009
}
}
]
},
"meta": {
"status": {
"code": "00",
"message_ilgn": [
{
"locale": "es_PE",
"value": "Se procesó correctamente la petición"
}
]
}
}
}