# First Data

# 1. Procesar pago

POST /pagos

Permite procesar un pago.

REQUEST

provider: (Tipo de dato: string). Nombre del Servicio de Pagos ("firstdata"). Campo obligatorio.
action: (Tipo de dato: string). Tipo de acción a ejecutar ("create"). Campo obligatorio.
card_number: (Tipo de dato: string). Número de tarjeta de crédito. Campo obligatorio.
exp_month: (Tipo de dato: string). Mes de vencimiento de la tarjeta. Se informa con 2 dígitos (Ejemplo: "07"). Campo obligatorio.
exp_year: (Tipo de dato: string). Año de vencimiento de la tarjeta. Informar los últimos dos dígitos (Ejemplo: "28"). Campo obligatorio.
sec_code: (Tipo de dato: string). Código de seguridad de la tarjeta. Campo obligatorio.
currency: (Tipo de dato: string). Código de moneda. Para pesos es "032". Campo obligatorio.
amount: (Tipo de dato: string). Monto a cobrar.Acepta decimales usando punto (Ejemplo: 1200.43). Campo obligatorio.
user: (Tipo de dato: string). Código de usuario provisto por Fiserv. Campo obligatorio.
password: (Tipo de dato: string). Contraseña provista por Fiserv. Campo obligatorio.
secret: (Tipo de dato: string). Clave para desencriptar las credenciales TLS. Campo obligatorio.
client: (Tipo de dato: string). Nombre de la marca en minúsculas. (Ejemplo: penguin, pcda). Campo obligatorio.
reference_id: (Tipo de dato: string). Id de la orden. (Ejemplo: penguin, pcda). Campo obligatorio.

{ 
    "provider": "firstdata",
    "action": "create",
    "password": "C34F_bu>qE",
    "user": "WS5923010603._.1",
    "secret": "xD5Q8-`ijb",
    "client": "test",
    "amount": "2900.99",
    "card_number": "4704550000000005",
    "currency": "032",
    "exp_month": "12",
    "exp_year": "29",
    "sec_code": "123",
    "reference_id": "123654"
}

RESPONSE

order_id: Id único que identifica la transacción. Se utiliza para la devolución de un pago.
transaction_result: Status de la transacción.
transaction_id: Se utiliza para anular un pago.
approval_code: Código de aprobación. No se utiliza en otras transacciones. Sirve de referencia para contactar al soporte en caso de problemas con la transacción.

{
    "approval_code": "Y:223592:4633045641:PPXX:2235925076",
    "card_brand": "VISA",
    "order_id": "A-522df995-7fec-4a09-a2a9-bd12f5cf1ad5",
    "payment_type": "CREDITCARD",
    "transaction_result": "APPROVED",
    "transaction_id": "84633045641"
}

# 2. Devolución de pago

Se utiliza para gestionar la devolución de un pago.

POST /pagos

REQUEST

provider: (Tipo de dato: string). Nombre del Servicio de Pagos ("firstdata"). Campo obligatorio.
action: (Tipo de dato: string). Tipo de acción a ejecutar ("refund"). Campo obligatorio.
user: (Tipo de dato: string). Código de usuario provisto por Fiserv. Campo obligatorio.
password: (Tipo de dato: string). Contraseña provista por Fiserv. Campo obligatorio.
secret: (Tipo de dato: string). Clave para desencriptar las credenciales TLS. Campo obligatorio.
client: (Tipo de dato: string). Nombre de la marca en minúsculas. (Ejemplo: penguin, pcda). Campo obligatorio.
amount: (Tipo de dato: string). Monto a anular. Debe ser exactamente igual al del pago realizado. Campo obligatorio.
payment_id: (Tipo de dato: string). Identificador del pago. Es el transaction_id devuelto al procesar un pago. Campo obligatorio.

{
    "provider": "firstdata",
    "action": "refund",
    "password": "C34F_bu>qE",
    "user": "WS5923010603._.1",
    "secret": "xD5Q8-`ijb",
    "client": "test",
    "amount": "2900.99",
    "payment_id": "84633045641"
}

RESPONSE

order_id: Id único que identifica la transacción. Es igual a la del pago.
transaction_result: Status de la transacción.
approval_code: Código de aprobación. No se utiliza en otras transacciones. Sirve de referencia para contactar al soporte en caso de problemas con la transacción.

{
    "approval_code": "Y:592466:4632779441:PPXX:5924665055",
    "card_brand": "VISA",
    "order_id": "A-af182a39-da8b-4664-8f0d-171d0a0f08e1",
    "payment_type": "CREDITCARD",
    "transaction_result": "APPROVED"
}

# 3. Anulación de pago

Se utiliza para anular un pago. Solo hasta antes del cierre de lote del día de la venta (23.30 hs)

POST /pagos

REQUEST

provider: (Tipo de dato: string). Nombre del Servicio de Pagos ("firstdata"). Campo obligatorio.
action: (Tipo de dato: string). Tipo de acción a ejecutar ("cancel"). Campo obligatorio.
user: (Tipo de dato: string). Código de usuario provisto por Fiserv. Campo obligatorio.
password: (Tipo de dato: string). Contraseña provista por Fiserv. Campo obligatorio.
secret: (Tipo de dato: string). Clave para desencriptar las credenciales TLS. Campo obligatorio.
client: (Tipo de dato: string). Nombre de la marca en minúsculas. (Ejemplo: penguin, pcda). Campo obligatorio.
amount: (Tipo de dato: string). Monto a anular. Debe ser exactamente igual al del pago realizado. Campo obligatorio.
payment_id: (Tipo de dato: string). Identificador del pago. Para anulación va el transaction_id devuelto al procesar un pago. Campo obligatorio.

{
    "provider": "firstdata",
    "action": "cancel",
    "password": "C34F_bu>qE",
    "user": "WS5923010603._.1",
    "secret": "xD5Q8-`ijb",
    "client": "test",
    "amount": "2900.99",
    "payment_id": "84633044966"
}

RESPONSE

order_id: Id único que identifica la transacción. Es igual a la del pago.
transaction_result: Status de la transacción.
approval_code: Código de aprobación. No se utiliza en otras transacciones. Sirve de referencia para contactar al soporte en caso de problemas con la transacción.

{
    "approval_code": "Y:223570:4633044967:PPXX:2235701296",
    "card_brand": "VISA",
    "order_id": "A-d2953c05-d8a4-415a-b99c-61cc69be0fec",
    "payment_type": "CREDITCARD",
    "transaction_result": "APPROVED"
}

# 4. Obtener detalle de pago

Permite obtener todas las operaciones sobre una transacción.

POST /pagos

REQUEST

provider: (Tipo de dato: string). Nombre del Servicio de Pagos ("firstdata"). Campo obligatorio.
action: (Tipo de dato: string). Tipo de acción a ejecutar ("obtain_payment_info"). Campo obligatorio.
user: (Tipo de dato: string). Código de usuario provisto por Fiserv. Campo obligatorio.
password: (Tipo de dato: string). Contraseña provista por Fiserv. Campo obligatorio.
secret: (Tipo de dato: string). Clave para desencriptar las credenciales TLS. Campo obligatorio.
client: (Tipo de dato: string). Nombre de la marca en minúsculas. (Ejemplo: penguin, pcda). Campo obligatorio.
payment_id: (Tipo de dato: string). Identificador del pago. Es el order_id devuelto al procesar un pago. Campo obligatorio.

{
    "provider": "firstdata",
    "action": "obtain_payment_info",
    "password": "C34F_bu>qE",
    "user": "WS5923010603._.1",
    "secret": "xD5Q8-`ijb",
    "client": "test",
    "payment_id": "A-522df995-7fec-4a09-a2a9-bd12f5cf1ad5"
}

RESPONSE

Devuelve un listado de operaciones aplicadas a la una transacción.