Pago
Se identifica como pago, a una transacción realizada por el usuario dentro de una sesión de pago.
Reembolsos
El endpoint de reembolsos permite revertir una transacción aprobada. Ver más en Reembolsos
Reembolsar pago
Permite reembolsar un pago aprobado con el código de referencia interna internalReference
.
Solicitud
- Name
auth
- Type
- Authentication
- is Required
- REQUIRED
- Description
La autenticación del sitio. Ver más en Autenticación
- Name
internalReference
- Type
- integer
- is Required
- REQUIRED
- Description
Referencia interna única de la transacción
Ejemplo:543423
- Name
amount
- Type
- Amount
- is optional
- Description
Información del monto a cobrar. Esta propiedad se envía cuando se desea realizar un reembolso con un valor menor al monto total de la transacción.
Solicitud
curl -X "POST" https://checkout-test.placetopay.com/api/session/000000 \
-H "Content-Type: application/json" \
-d '{
"auth": {
"login": "aabbccdd1234567890aabbccdd123456",
"tranKey": "ABC123example456trankey+789abc012def3456ABC=",
"nonce": "NjE0OWVkODgwYjNhNw==",
"seed": "2021-09-21T09:34:48-05:00"
},
"internalReference": 1
}'
Respuesta
OK
- Name
status
- Type
- Status
- is optional
- Description
Estructura que contiene la información de la respuesta sobre una solicitud o pago, e informa el estado actual de la misma.
- Name
payment
- Type
- PaymentResponse
- is optional
- Description
Respuesta
{
"status": {
"status": "APPROVED",
"reason": "00",
"message": "Aprobada",
"date": "2021-12-07T16:01:19-05:00"
},
"payment": {
"status": {
"status": "APPROVED",
"reason": "00",
"message": "Aprobada",
"date": "2021-12-07T16:01:18-05:00"
},
"internalReference": 1,
"paymentMethod": "visa",
"paymentMethodName": "Visa",
"issuerName": "JPMORGAN CHASE BANK, N.A.",
"amount": {
"from": {
"currency": "USD",
"total": 100
},
"to": {
"currency": "USD",
"total": 100
},
"factor": 1
},
"authorization": "123456",
"reference": "12345",
"receipt": "230955511860",
"franchise": "PS_VS",
"refunded": false,
"processorFields": [
{
"keyword": "merchantCode",
"value": "1465675",
"displayOn": "none"
},
{
"keyword": "terminalNumber",
"value": "00990099",
"displayOn": "none"
},
{
"keyword": "credit",
"value": {
"code": "1",
"type": "00",
"groupCode": "C",
"installments": 1
},
"displayOn": "none"
},
{
"keyword": "totalAmount",
"value": 52,
"displayOn": "none"
},
{
"keyword": "interestAmount",
"value": 0,
"displayOn": "none"
},
{
"keyword": "installmentAmount",
"value": 0,
"displayOn": "none"
},
{
"keyword": "iceAmount",
"value": 0,
"displayOn": "none"
},
{
"keyword": "bin",
"value": "411111",
"displayOn": "none"
},
{
"keyword": "expiration",
"value": "1223",
"displayOn": "none"
},
{
"keyword": "lastDigits",
"value": "1111",
"displayOn": "none"
},
{
"keyword": "id",
"value": "a10fe0690cfe557283310ba90746e159",
"displayOn": "none"
},
{
"keyword": "b24",
"value": "00",
"displayOn": "none"
}
]
}
}
Acciones de transacción
Permite realizar operaciones básicas de preauthorización como checkout
, reauthorization
, (No aplica para Puerto Rico) por otro lado también permite revertir un pago aprobado con el código de referencia interna reverse
.
Solicitud
Estructura que permite realizar solicitudes de preauthorización como checkout
, reauthorization
y reverse
- Name
auth
- Type
- Authentication
- is Required
- REQUIRED
- Description
La autenticación del sitio. Ver más en Autenticación
- Name
action
- Type
- string
- is Required
- REQUIRED
- Description
Tipo de operación a realizar sobre la transacción
reverse
para reembolsar una transacción.
reauthorization
para modificar una transacción de checkin.
checkout
para cerrar y cobrar una transacción de checkin.Valores permitidos:checkout
reauthorization
reverse
Ejemplo:checkout
- Name
internalReference
- Type
- integer
- is Required
- REQUIRED
- Description
Referencia interna única de la transacción
Ejemplo:543423
- Name
amount
- Type
- Amount
- is optional
- Description
Información del monto a cobrar
Solicitud
curl -X "POST" https://checkout-test.placetopay.com/api/transaction \
-H "Content-Type: application/json" \
-d "{
"auth": {
"login": "aabbccdd1234567890aabbccdd123456",
"tranKey": "ABC123example456trankey+789abc012def3456ABC=",
"nonce": "NjE0OWVkODgwYjNhNw==",
"seed": "2021-09-21T09:34:48-05:00"
},
"internalReference": 640,
"amount": {
"currency": "USD",
"total": "500"
},
"action": "checkout"
}"
Respuesta
OK
- Name
reference
- Type
- string
- is Required
- REQUIRED
- Description
Referencia única del pago. compuesta por hasta 32 caracteres alfanuméricos y símbolos permitidos EJ:
PAYMENT_0001_ABC
,Venta_1234-ABCD#2024/03/15$500
,Ord: 1001/2023
Ejemplo:PAYMENT_0001_ABC
- Name
description
- Type
- string
- is Required
- REQUIRED
- Description
Descripción del proceso a realizar, permitiendo hasta 250 caracteres alfanuméricos, acentuados y símbolos comunes.
Ejemplo:Cita con el Dr. Pérez a las 10:00 am. 5/12/2024, por $100.00
- Name
amount
- Type
- Amount
- is Required
- REQUIRED
- Description
Información del monto a cobrar
- Name
allowPartial
- Type
- boolean
- is optional
- Description
Define si el monto a ser cobrado puede ser pagado en varias transacciones. Cuando es
true
el usuario podrá completar el pago en varias transacciones.Valor por defecto:false
- Name
shipping
- Type
- Person
- is optional
- Description
Estructura para relacionar información de envío.
- Name
items
- Type
- array[Item]
- is optional
- Description
Estructura para relacionar productos o artículos en el proceso.
- Name
fields
- Type
- array[NameValuePair]
- is optional
- Description
Estructura para relacionar información adicional en el proceso. Ver más en Campos Adicionales
- Name
recurring
- Type
- object
- is optional
- Description
Estructura para indicar la frecuencia de un cobro recurrente.
- Name
subscribe
- Type
- boolean
- is optional
- Description
Cuando se envía
true
, se genera una sesión de pago con suscripción.En el proceso de pago, el usuario puede elegir si quiere o no guardar su medio de pago para que sea usado en futuros cobros.
Valor por defecto:false
- Name
dispersion
- Type
- array[DispersionDetail]
- is optional
- Description
Cuando se define, se genera una sesión de pago con dispersión. El pago generado puede ser dividido en diferentes destinos según las condiciones dadas.
- Name
modifiers
- Type
- array[Modifiers]
- is optional
- Description
Estructura para definir modificadores en el cobro.
Aplica para leyes de impuestos en paises especificos.
- Name
processorFields
- Type
- array[NameValuePair]
- is optional
- Description
Estructura que puede variar en el tiempo según la información disponible para el medio de pago. Ver más en Datos de procesamiento
Respuesta
{
"reference": "12345",
"description": "Prueba de pago",
"amount": {
"currency": "COP",
"total": 2000,
"taxes": [
{
"kind": "valueAddedTax",
"amount": 1000,
"base": 0
}
],
"details": [
{
"kind": "discount",
"amount": 1000
}
]
},
"allowPartial": false,
"shipping": {
"document": "1122334455",
"documentType": "CC",
"name": "John",
"surname": "Doe",
"company": "Evertec",
"email": "[email protected]",
"mobile": "+5731111111111",
"address": {
"street": "Calle falsa 123",
"city": "Medellín",
"state": "Poblado",
"postalCode": "55555",
"country": "CO",
"phone": "+573111111111"
}
},
"items": [
{
"sku": "12345",
"name": "product_1",
"category": "physical",
"qty": "1",
"price": 1000,
"tax": 0
}
],
"fields": [
{
"keyword": "_test_field_value_",
"value": "_test_field_",
"displayOn": "approved"
}
],
"recurring": {
"periodicity": "D",
"interval": "1",
"nextPayment": "2019-08-24",
"maxPeriods": 1,
"dueDate ": "2019-09-24",
"notificationUrl ": "https://checkout.placetopay.com"
},
"subscribe": false,
"dispersion": [
{
"agreement": "1299",
"agreementType": "MERCHANT",
"amount": {
"currency": "USD",
"total": 200
}
}
],
"modifiers": [
{
"type": "FEDERAL_GOVERNMENT",
"code": 17934,
"additional": {
"invoice": "123345"
}
}
]
}