# CTC

# 1. Consultar datos de una Gift Card

POST /pagos

Devuelve el saldo en pesos de una Gift Card y otros datos asociados a la misma.

REQUEST

  • provider: (Tipo de dato: string). Nombre del Servicio de Pagos ("ctc"). Campo obligatorio.

  • action: (Tipo de dato: string). Tipo de acción a ejecutar ("get_saldo"). Campo obligatorio.

  • card_number: (Tipo de dato: string). Número de tarjeta de Gift Card sin espacios ni otros caracteres intermedios. Campo obligatorio.

  • secret: (Tipo de dato: string). Clave de autorización del cliente provista por CTC. Campo obligatorio.

  • site_id: (Tipo de dato: string). Código numérico de la marca. Campo obligatorio.

{
    "provider": "ctc",
    "action": "get_saldo",
    "card_number": "6375043481300301489",
    "secret": "cC84NEdTZHhORHVTTE45SGZEdmlIWHJwcGdxcDA5cWk=",
    "site_id": "348"
}

RESPONSE

  • responseDetail.Entity_CurrentMoney.CurrentMoney: Saldo actual en pesos.

  • responseDetail.Entity_CurrentMoney.HistoricMoney: Saldo original en pesos.

  • responseDetail.Entity_Card.Deleted: Condición de eliminada.

  • responseDetail.Entity_Card.Enabled: Condición de habilitada.

  • responseDetail.Entity_Card.ExpirationDate: Fecha de vencimiento.

{
    "responseCode": 0, 
    "responseDetail": {
        "message": "OK", 
        "Entity_CurrentMoney": {
                "CurrentMoney": 150.00,
                "HistoricMoney": 150.00 
        },
        "Entity_Card": {
            "CardID": "6375040010100000497", 
            "CardTypeID": 1,
            "CardCategoryID": 2,
            "CardStateID": 6,
            "PersonID": 15052,
            "Deleted": false,
            "Enabled": true,
            "ExpirationDate": "2023-12-01T00:00:00", 
            "IdRazSocial": ""
        }, 
        "Entity_CardState": {
            "Name": "Habilitada para Compras
            "CardStateID": 6 
        },
        "Entity_CardType": { 
            "CardTypeID": 1, 
            "Name": "150", 
            "Enabled": 1
        }, 
        "Entity_CardCategory": {
            "CardCategoryID": 2, 
            "Name": "Virtual ,
            "Enabled": 1
        } 
    }
}

# 2. Pagar con Gift Card

Autoriza el pago de un importe con una Gift Card.

POST /pagos

REQUEST

  • provider: (Tipo de dato: string). Nombre del Servicio de Pagos ("ctc"). Campo obligatorio.

  • action: (Tipo de dato: string). Tipo de acción a ejecutar ("burn_credit"). Campo obligatorio.

  • card_number: (Tipo de dato: string). Número de tarjeta de Gift Card sin espacios ni otros caracteres intermedios. Campo obligatorio.

  • secret: (Tipo de dato: string). Clave de autorización del cliente provista por CTC. Campo obligatorio.

  • site_id: (Tipo de dato: string). Código numérico de la marca. Campo obligatorio.

  • exp_month: (Tipo de dato: string). Mes de Vencimiento de la Gift Card (mm). Campo obligatorio.

  • exp_year: (Tipo de dato: integer). Año de Vencimiento de la Gift Card (aaaa). Campo obligatorio.

  • sec_code: (Tipo de dato: integer). Código de Seguridad de la Gift Card. Campo obligatorio.

  • amount: (Tipo de dato: float). Importe a debitar de la Gift Card. Va con 2 posiciones decimales separadas por un punto "." (Ejemplo: 1500.00) Campo obligatorio.

{
    "provider": "ctc",
    "action": "burn_credit",
    "secret": "cC84NEdTZHhORHVTTE45SGZEdmlIWHJwcGdxcDA5cWk=",
    "card_number": "6375043482400008388",
    "site_id": "348",
    "exp_month": "06",
    "exp_year": 2023,
    "sec_code": 986,
    "amount": 100.00
}

RESPONSE

  • responseCode: Vienen en O (cero) cuando la operación es exitosa.

  • operationCode: Código de la operación. Se utiliza para eventualmente anular el pago.

{
    "responseCode": 0,
    "responseDetail": {
        "message": "La operación se realizó con éxito",
        "operationCode": "EXT-638231474326727001"
    }
}

# 3. Anulación de pago con Gift Card

POST /pagos

Cancela un pago realizado con una Gift Card, y restituye el importe correspondiente al saldo de la misma.

REQUEST

  • provider: (Tipo de dato: string). Nombre del Servicio de Pagos ("ctc"). Campo obligatorio.

  • action: (Tipo de dato: string). Tipo de acción a ejecutar ("reverso_tecnico"). Campo obligatorio.

  • card_number: (Tipo de dato: string). Número de tarjeta de Gift Card sin espacios ni otros caracteres intermedios. Campo obligatorio.

  • secret: (Tipo de dato: string). Clave de autorización del cliente provista por CTC. Campo obligatorio.

  • site_id: (Tipo de dato: string). Código numérico de la marca. Campo obligatorio.

  • amount: (Tipo de dato: float). Importe de la compra original, para cancelar. Va con 2 posiciones decimales separadas por un punto "." (Ejemplo: 1500.00) Campo obligatorio.

{
    "provider": "ctc",
    "action": "reverso_tecnico",
    "secret": "cC84NEdTZHhORHVTTE45SGZEdmlIWHJwcGdxcDA5cWk=",
    "card_number": "6375043482200017852",
    "site_id": "348",
    "secuence_number": "EXT-638232006880863748",
    "amount": 100.00
}

RESPONSE

  • responseCode: Vienen en O (cero) cuando la operación es exitosa.
{
    "responseCode": 0,
    "responseDetail": {
        "message": "La operación se realizó con éxito",
        "operationCode": "EXT-638231474326727001"
    }
}