Synchronization API
by vendemas-trx

Synchronization API

API para la Sincronización de Transacciones.
https://api-vendemas.preprod.geopagos.com
Enviar Transacción
POST /api/transactions

Authentication

Basic Auth

Enviar Transacciones a BO.

Request headers

Content-Type
string required
Default:
application/json

Request body

Object
type
string

tipo de transaccion

Examples:
SALEANNULMENT
entryMode
string
Examples:
EMVSWIPENFC
merchantIdentifier
string
Examples:
602370409602370401
nbo
string
Example:
046310489
responseCode
string
Example:
APPROVED
externalResponseCode
string
Examples:
000400
responseMessage
string
Example:
Approved 239854 (00)
authorizationCode
string
Example:
239854
traceNumber
string
Example:
218003
processorId
string
Example:
123456789012350
referenceNumber
string
Example:
932114062323
localDateTime
integer
Example:
1575338238777
fullSerialNumber
string
Example:
68514357
amount
number
Example:
68.99
currency
string
Example:
604
installments
integer
Example:
2
cardNumber
string
Example:
5254********2776
cardHolderName
string
Example:
""
holderIdentificationType
string
Example:
""
holderIdentificationNumber
string
Example:
""
latitude
number
Example:
0
longitude
number
Example:
0
Examples

Json Boby Request

{
    "type": "SALE",
    "entryMode": "EMV",
    "merchantIdentifier": "602370409",
    "nbo": "046310489",
    "responseCode": "APPROVED",
    "externalResponseCode": "000",
    "responseMessage": "Approved 239854 (00)",
    "authorizationCode": "239854",
    "traceNumber": "218003",
    "processorId": "123456789012350",
    "referenceNumber": "932114062323",
    "localDateTime": 1575338238777,
    "fullSerialNumber": "68514357",
    "amount": 68.99,
    "currency": "604",
    "installments": 2,
    "cardNumber": "5254********2776",
    "cardHolderName": "",
    "holderIdentificationType": "",
    "holderIdentificationNumber": "",
    "latitude": 0.0,
    "longitude": 0.0
}

Responses

200 OK
Body
Object
id
integer
Example:
3701
url
string
Example:
https://backend-vendemas.preprod.geopagos.com/backend/transactions/3701
Examples

Si la Transacción es registrada correctamente muestra el response body con el ID de la transacción y la URL para acceder al detalle de la transacción en BO.

{
    "id": 3701,
    "url": "https://backend-vendemas.preprod.geopagos.com/backend/transactions/3701"
}
400 Bad Request
Body

Si existe error siempre retorna: (Response Code 400) y dentro del response body el código de error y el mensaje.

Object
error
string
Example:
transaction.errors.poket_pro.transaction_exists
response
Object
code
string
Example:
06
message
string
Example:
Transacción duplicada
Examples

Error Code 06 - Transacción duplicada

{
    "error": "transaction.errors.poket_pro.transaction_exists",
    "response": {
        "code": "06",
        "message": "Transacción duplicada"
    }
}

Error Code 03 - Transacción duplicada

{
    "error": "transaction.errors.poket_pro.reader_not_found",
    "response": {
        "code": "03",
        "message": "Lector no encontrado"
    }
}