Placetopay Docs

POST/gateway/mpi/lookup

3DS Lookup

Performs the initial validation process of 3DS Server, returning the data so that the user can continue with the authentication process.

Request

Name
auth
Type
Autenticación
is optional
Description
Structure that contains the site authentication information generated according to the WSSE UsernameToken Profile 1.1
Name
login
Type
string
is optional
Description
Name
tranKey
Type
string
is optional
Description
Name
nonce
Type
string
is optional
Description
Name
seed
Type
string
is optional
Description
Name
userAgent
Type
string
is optional
Description
User Agent Information
Example:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.212 Safari/537.36
Name
buyer
Type
object
is optional
Description
Name
address
Type
Address
is optional
Description
Structure that contains information about a physical address
Name
street
Type
string
is optional
Description
Street
Max length:128
Name
city
Type
string
is optional
Description
City
Max length:30
Name
state
Type
string
is optional
Description
State/province/department. ISO 3166-2 code
Example:NY
Name
postalCode
Type
string
is optional
Description
Postal Code
Example:110111
Max length:10
Name
country
Type
string
is optional
Description
Country code. ISO 3166-1 alpha-2 code
Example:CO
Max length:2
Name
phone
Type
string
is optional
Description
Phone number
Example:3003003000
Max length:20
Name
payer
Type
object
is optional
Description
Name
name
Type
string
is optional
Description
Example:John
Name
surname
Type
string
is optional
Description
Example:Doe
Name
email
Type
string
is optional
Description
Example:[email protected]
Name
mobile
Type
string
is optional
Description
El numero celular puede contener el indicativo del país
Example:+573195505452
Name
address
Type
Address
is optional
Description
Structure that contains information about a physical address
Name
street
Type
string
is optional
Description
Street
Max length:128
Name
city
Type
string
is optional
Description
City
Max length:30
Name
state
Type
string
is optional
Description
State/province/department. ISO 3166-2 code
Example:NY
Name
postalCode
Type
string
is optional
Description
Postal Code
Example:110111
Max length:10
Name
country
Type
string
is optional
Description
Country code. ISO 3166-1 alpha-2 code
Example:CO
Max length:2
Name
phone
Type
string
is optional
Description
Phone number
Example:3003003000
Max length:20
Name
instrument
Type
Instrument
is optional
Description
Structure that contains information about the means of payment to be used in a transaction. This structure is variable according to the request that is generated. Each service requires that one or another data be used.
Name
card
Type
Card
is optional
Description
Structure containing card information.
Name
number
Type
string
is Required
REQUIRED
Description
Max length:20
Name
expiration
Type
string
is optional
Description
Example:12/22
Pattern:^[01]\d\/\d{2}$
Name
cvv
Type
string
is optional
Description
Name
installments
Type
number
is optional
Description
Name
account
Type
Account
is optional
Description
Structure that contains bank account information.
Name
bankName
Type
string
is optional
Description
Name of the bank of the account to be processed
Max length:30
Name
bankCode
Type
string
is Required
REQUIRED
Description
Code that identifies the bank on the network
Max length:17
Name
accountType
Type
string
is Required
REQUIRED
Description
Account type
Allowed values:SAVDDACCD
Name
accountNumber
Type
string
is Required
REQUIRED
Description
Account number
Max length:17
Name
franchise
Type
string
is optional
Description
Max length:20
Name
verificationCode
Type
string
is optional
Description
The verificationCode is a JSON Web Signature (JWS). It is intended to be the instrument for verifying the status of the account
Example:eyJhbGciOiJSUzI1NiJ9.eyJhY2NvdW50SGFzaCI6ImM5YWM2ZjFhZDhjNDA3Y2ZjNzMyNDljNTE2MTJjNTdmMWQxZGNiNTA4YjE4ZGJlYWE1MWQ0NDI5NjBjMjUwNDUyMzY4ZTg2YmUzMWQ3MDMxMDY4ZDM2MjM2NzVjYzhkYTUzNzhhODNmMTUwZjg5OTczOTBiZTEyMGU1ZmExN2RhIiwib25UZXN0Ijp0cnVlLCJzZXJ2aWNlIjoibW9jayIsImlkIjo0MDB9.dFMY4EwCrWq9EBmERFkKCoLHExPH4vgaCgnZaqB_mf8n3Sv6Qnu6Pb79onluX1OZecmYmBuHqZ_ykKXWSD4RMZSpckYFCiO3mlcJKI4qb91COhl_c2qXxYJuLEdbLfGlzf0k8-oJgFcO9gAS1Xm0hpTP4iiXF6st1hFwlfR3fpX4rr-bTsKgMvRSReMuxa0Vs92DykfqUR_3udlc0DFCPB9ZTaSqeRNHFAPAWNniUPWURQlW5c9J9xcyKTgKGzfI1_7h2I4ALQeRifptE2nC-HZtEMwtcToNh7hn0oL9lNFXnXGK9sWKORcyWKVfpEChS8z30UfX6kOhU6fp_qUwmA
Name
token
Type
Token
is optional
Description
Structure that contains the token information associated with the card. For entry, only the token or subtoken and the cvv are necessary if it is an operation where the user is present. For output if all data is returned when tokenizing.
Name
token
Type
string
is optional
Description
Code generated to identify the card in the system
Max length:64
Min length:64
Name
subtoken
Type
string
is optional
Description
Alternate code generated to identify the card
Max length:16
Min length:16
Name
franchise
Type
string
is optional
Description
Franchise code associated with the token (Only as a response, it is not necessary to send it)
Allowed values:visavisa_electronamexmastercodensadinersjbcdiscoverriscredencialcomfamacolsubsidiofalabellaelosomostuyaexitoalkostomaestromefiaath_card
Name
franchiseName
Type
string
is optional
Description
Name
issuerName
Type
string
is optional
Description
Name
lastDigits
Type
string
is optional
Description
Name
validUntil
Type
string
is optional
Description
Name
cvv
Type
string
is optional
Description
CVV requested from the user in case it is present in the operation
Max length:4
Min length:3
Name
credit
Type
Credit
is optional
Description
Structure that contains information on the type of credit
Name
code
Type
string
is optional
Description
Name
type
Type
string
is optional
Description
Name
groupCode
Type
string
is optional
Description
Name
installment
Type
integer
is optional
Description
Name
threeDS
Type
object
is optional
Description
Name
version
Type
string
is Required
REQUIRED
Description
Allowed values:v2v2x
Name
id
Type
number
is optional
Description
This value only applies if the validation was done with the Placetopay 3DS service
Name
enrolled
Type
string
is Required
REQUIRED
Description
Reports whether the card is registered in 3DS
Allowed values:YNU
Min length:1
Name
authenticated
Type
string
is Required
REQUIRED
Description
Allowed values:YNUAICDR
Max length:1
Min length:1
Name
eci
Type
string
is Required
REQUIRED
Description
Authentication result indicator generated by e-commerce.
Allowed values:020100050607
Min length:1
Name
cavv
Type
string
is Required
REQUIRED
Description
Authentication value for the franchise generated by the ACS. (3DS field authenticationValue).
Example:AJkBABIWcQAAAAM5FwIzdGiYeHM
Max length:28
Min length:28
Nullable:Yes
Name
xid
Type
string
is Required
REQUIRED
Description
DS Transaction ID (3DS dsTransID field).
Min length:1
Name
extra
Type
object
is optional
Description
Name
transStatusReason
Type
string
is optional
Description
Provides information about the status of the transaction.
Nullable:Yes
Name
acsTransId
Type
string
is optional
Description
Unique transaction identifier generated by the ACS.
Example:37a7b6e0-fd58-4e38-98de-79c70c526a47
Name
threeDSServerTransID
Type
string
is optional
Description
Unique transaction identifier generated by the 3DS Server.
Example:eadd3a60-b870-41d0-977f-921b3dbe6323/MkGJDl2Y5E=
Name
validSignature
Type
boolean
is optional
Description
Name
otp
Type
string
is optional
Description
Name
pinPad
Type
PinPad
is optional
Description
Structure containing PinPad service information
Name
transactionId
Type
string
is optional
Description
Name
positions
Type
string
is optional
Description
Name
pinBlock
Type
string
is optional
Description
Name
length
Type
integer
is optional
Description
Name
pin
Type
string
is optional
Description
Receives the PIN code when it is flat or when it is a PinBlock
Example:0B880E2326F6409E
Max length:20
Min length:2
Name
redirection
Type
Redirection
is optional
Description
It represents a redirect payment method, meaning that it requires the user to be sent to another URL to complete the process.
Name
paymentMethod
Type
string
is optional
Description
Allowed values:_PSE_BTNBCBTNBCPGEFT
Name
returnURL
Type
string
is optional
Description
URL so that once the payment process is completed, control is returned (when applicable)
Example:http://your-site.com/your-return-route
Format:uri
Max length:250
Name
processURL
Type
string
is optional
Description
URL to which the client must be sent to continue the process, it is provided by the service
Format:uri
Max length:250
Name
additional
Type
object
is optional
Description
Estructura para relacionar datos adicionales en el proceso.
Name
bankCode
Type
string
is optional
Description
Código que identifica al banco en la red.
Example:1007
Name
userType
Type
string
is optional
Description
Example:person
Name
kount
Type
Kount
is optional
Description
Manages specific information to use with the Kount risk filter
Name
session
Type
string
is Required
REQUIRED
Description
Identifier of this operation in Kount, it must be unique per transaction
Name
type
Type
string
is optional
Description
Describes the type of operation that is being handled in the session to define the additional fields to be sent
Allowed values:airlinesoat
Name
pocket
Type
string
is optional
Description
Card pocket used for payment
Name
payment
Type
Payment
is optional
Description
Structure that contains the information about the payment of the transaction required to the web service
Name
reference
Type
string
is optional
Description
Max length:32
Min length:1
Name
description
Type
string
is optional
Description
Max length:250
Name
amount
Type
Amount
is optional
Description
Structure that contains the information about the payment of the transaction required to the web service
Name
currency
Type
string
is Required
REQUIRED
Description
Allowed values:USDCOPCRCEURCADAUDGBPMXNCLP
Example:COP
Max length:3
Min length:3
Name
total
Type
number
is Required
REQUIRED
Description
Name
taxes
Type
array[TaxDetail]
is optional
Description
Name
kind
Type
string
is optional
Description
Tipo de impuesto reportado
Allowed values:valueAddedTaxexciseDutyiceairportTaxstateTaxreducedStateTaxmunicipalTax
Example:valueAddedTax
Name
amount
Type
number
is optional
Description
Name
base
Type
number
is optional
Description
Name
details
Type
array[AmountDetail]
is optional
Description
Name
kind
Type
string
is optional
Description
Name
amount
Type
number
is optional
Description
Name
dispersion
Type
array[Dispersion]
is optional
Description
Name
agreement
Type
number
is optional
Description
Transaction recipient identifier. For the primary transaction site, the value must be null.
Nullable:Yes
Name
agreementType
Type
string
is optional
Description
Allowed values:AIRLINEMERCHANT
Name
amount
Type
Amount
is optional
Description
Structure that contains the information about the payment of the transaction required to the web service
Name
currency
Type
string
is Required
REQUIRED
Description
Allowed values:USDCOPCRCEURCADAUDGBPMXNCLP
Example:COP
Max length:3
Min length:3
Name
total
Type
number
is Required
REQUIRED
Description
Name
taxes
Type
array[TaxDetail]
is optional
Description
Name
kind
Type
string
is optional
Description
Tipo de impuesto reportado
Allowed values:valueAddedTaxexciseDutyiceairportTaxstateTaxreducedStateTaxmunicipalTax
Example:valueAddedTax
Name
amount
Type
number
is optional
Description
Name
base
Type
number
is optional
Description
Name
details
Type
array[AmountDetail]
is optional
Description
Name
kind
Type
string
is optional
Description
Name
amount
Type
number
is optional
Description
Name
modifiers
Type
array[PaymentModifier]
is optional
Description
Structure containing payment modifiers
Name
type
Type
string
is optional
Description
Modifier type
Allowed values:FEDERAL_GOVERNMENT
Name
code
Type
string
is optional
Description
Modifier code. When the type is FEDERAL_GOVERMENT, it represents the law number for discount.
Example:17934
Name
additional
Type
object
is optional
Description
Additional modifier information
Name
invoice
Type
string
is optional
Description
Invoice number. Required when type is FEDERAL_GOVERMENT.
Name
shipping
Type
Person
is optional
Description
Structure for relating shipping information.
Name
documentType
Type
string
is optional
Description
Type of identification document
Allowed values:CCNITRUTTIPNN
Example:CC
Max length:3
Name
Document
Type
string
is optional
Description
Identification document number.
Name
name
Type
string
is optional
Description
Names
Name
surname
Type
string
is optional
Description
Surnames
Name
company
Type
string
is optional
Description
Company
Name
email
Type
string
is optional
Description
Email.
Name
address
Type
Address
is optional
Description
Object that contains information about a person's address.
Name
street
Type
string
is optional
Description
Street
Max length:128
Name
city
Type
string
is optional
Description
City
Max length:30
Name
state
Type
string
is optional
Description
State/province/department. ISO 3166-2 code
Example:NY
Name
postalCode
Type
string
is optional
Description
Postal Code
Example:110111
Max length:10
Name
country
Type
string
is optional
Description
Country code. ISO 3166-1 alpha-2 code
Example:CO
Max length:2
Name
phone
Type
string
is optional
Description
Phone number
Example:3003003000
Max length:20
Name
mobile
Type
string
is optional
Description
Mobile phone
Name
subscription
Type
Subscription
is optional
Description
Structure that contains information about a subscription or transaction that does not require a specific amount
Name
reference
Type
string
is optional
Description
Max length:32
Name
description
Type
string
is optional
Description
Max length:254
Min length:1
Name
version
Type
string
is optional
Description
3DS version on which the request is being processed.
Allowed values:v2v2x
Nullable:Yes
Name
returnUrl
Type
string
is optional
Description
Return URL to regain user control
Format:uri
Max length:250
Name
additional
Type
object
is optional
Description
Name
initiatorIndicator
Type
string
is optional
Description
Actor that generates the transaction. It can be AGENT when it is different from the cardholder
Allowed values:AGENT
Nullable:Yes

Solicitud

POST

/gateway/mpi/lookup

curl -X "POST" https://api-co-dev.placetopay.ws/gateway/mpi/lookup \
-H "Content-Type: application/json" \
-d '{
    "auth": {
        "login": "6dd490faf9cb87a9862245da41170ff2",
        "tranKey": "81RuiCFgrjJ5VlSzTLqyC2cekqvq7vXQQwG1131+WK0=",
        "nonce": "bmVybzNzYms4cmE=",
        "seed": "2024-11-21T11:30:33-05:00"
    },
    "buyer": {
        "address": {
            "country": "CO",
            "state": "CUN",
            "city": "Bogota",
            "street": "cra 75 c 57 f 55",
            "postalCode": "110741",
        }
    },
    "payer": {
        "name": "payer name",
        "surname": "payer surname",
        "email": "[email protected]",
        "mobile": "+573195505458",
        "address": {
            "country": "CO",
            "state": "CUN",
            "city": "Bogota",
            "street": "cra 75 c 57 f 55",
            "postalCode": "110741",
            "phone": "3195505452"
        }
    },
    "payment": {
        "reference": "1234567890",
        "description": "Testing payment",
        "amount": {
            "currency": "COP",
            "total": 20000
        }
    },
    "instrument": {
        "card": {
            "number": "4111111111111111",
            "expiration": "05/28",
            "cvv": "123"
        }
    },
    "returnUrl": "https://www.your-site.com/return?reference=1234567890",
    "version": "v2x",
    "additional": {
        "initiatorIndicator": "AGENT"
    }
}
'

Response

Name
status
Type
Status
is optional
Description
Structure that contains information about a request or payment, informing its current status.
Name
status
Type
string
is optional
Description
Allowed values:OKFAILEDAPPROVEDAPPROVED_PARTIALPARTIAL_EXPIREDREJECTEDPENDINGPENDING_VALIDATIONPENDING_PROCESSREFUNDEDREVERSEDERRORUNKNOWNMANUALDISPUTE
Name
reason
Type
string
is optional
Description
Max length:4
Min length:1
Name
message
Type
string
is optional
Description
Name
date
Type
string
is optional
Description
Example:2021-09-21T09:34:48-05:00
Name
data
Type
is optional
Description
The fields described here correspond to a response from the 3DS service
Name
action
Type
string
is optional
Description
Allowed values:continueredirect
Example:continue
Name
version
Type
string
is Required
REQUIRED
Description
Allowed values:v2x
Name
sessionToken
Type
string
is optional
Description
Example:1bbf97e3660511d0ce82c15fca343307ba2f87fe84ba421368afb041ba1f638f
Name
redirectUrl
Type
string
is optional
Description
URL to which the client should be redirected to continue the authentication process.
Example:https://3dss-test.placetopay.com/threeds/v2/sessions/100950/examplea974d40500a650b6a77973985d367ad389a28b747dfdc918756a4ddc1
Name
id
Type
number
is optional
Description
Authentication session identifier.
Example:263325
Name
enrolled
Type
string
is Required
REQUIRED
Description
Present if action was continue. Indicates whether the card with which the transaction was made is enrolled (registered in the card ranges for the specific issuer).
Allowed values:YNU
Name
authenticated
Type
string
is Required
REQUIRED
Description
Present if action was continue. Reports the authentication status.
Allowed values:YNUAICDR
Max length:1
Name
validSignature
Type
boolean
is optional
Description
Present if action was continue. Reports whether the response signature is valid.
Name
eci
Type
string
is Required
REQUIRED
Description
Authentication code per franchise. Indicator of the authentication result generated by the e-commerce.
Name
cavv
Type
string
is Required
REQUIRED
Description
Present if action was continue. Authentication value for the franchise generated by the ACS. (3DS authenticationValue field).
Example:AJkBABIWcQAAAAM5FwIzdGiYeHM
Max length:28
Min length:28
Nullable:Yes
Name
xid
Type
string
is Required
REQUIRED
Description
Present if action was continue. DS Transaction ID (3DS field dsTransID).
Min length:1
Name
extra
Type
object
is optional
Description
Present if action was continue. Additional transaction information.
Name
transStatusReason
Type
string
is optional
Description
Provides information about the status of the transaction.
Nullable:Yes
Name
acsTransId
Type
string
is optional
Description
Unique transaction identifier generated by the ACS.
Example:37a7b6e0-fd58-4e38-98de-79c70c526a47
Name
threeDSServerTransID
Type
string
is optional
Description
Unique transaction identifier generated by the 3DS Server.
Example:eadd3a60-b870-41d0-977f-921b3dbe6323/MkGJDl2Y5E=

Response

{
    "status": {
        "status": "OK",
        "reason": "00",
        "message": "La petición se ha procesado correctamente",
        "date": "2021-09-21T12:09:36-05:00"
    },
    "data": {
        "action": "redirect",
        "version": "v2x",
        "sessionToken": "658aa6f85dd76d0189f1a7d085fc7fbfb735ca408bdaf1f9973fe10d6c6e8f9b",
        "redirectUrl": "https://3ds-server-to-authenticate.com/3ds",
        "id": 262147
    }
}

POST/gateway/mpi/query

3DS Query

Once an authentication session is started and the necessary validations have been generated, its status can be consulted to determine if the cardholder has been correctly authenticated.

Important Note

When consuming this service the transaction is NOT authenticated by default, the value of data must be taken from the response and sent in the instrument.threeDS

Request

Name
auth
Type
Autenticación
is Required
REQUIRED
Description
Structure that contains the site authentication information generated according to the WSSE UsernameToken Profile 1.1
Name
login
Type
string
is optional
Description
Name
tranKey
Type
string
is optional
Description
Name
nonce
Type
string
is optional
Description
Name
seed
Type
string
is optional
Description
Name
instrument
Type
Instrument
is optional
Description
Structure that contains information about the means of payment to be used in a transaction. This structure is variable according to the request that is generated. Each service requires that one or another data be used.
Name
card
Type
Card
is optional
Description
Structure containing card information.
Name
number
Type
string
is Required
REQUIRED
Description
Max length:20
Name
expiration
Type
string
is optional
Description
Example:12/22
Pattern:^[01]\d\/\d{2}$
Name
cvv
Type
string
is optional
Description
Name
installments
Type
number
is optional
Description
Name
account
Type
Account
is optional
Description
Structure that contains bank account information.
Name
bankName
Type
string
is optional
Description
Name of the bank of the account to be processed
Max length:30
Name
bankCode
Type
string
is Required
REQUIRED
Description
Code that identifies the bank on the network
Max length:17
Name
accountType
Type
string
is Required
REQUIRED
Description
Account type
Allowed values:SAVDDACCD
Name
accountNumber
Type
string
is Required
REQUIRED
Description
Account number
Max length:17
Name
franchise
Type
string
is optional
Description
Max length:20
Name
verificationCode
Type
string
is optional
Description
The verificationCode is a JSON Web Signature (JWS). It is intended to be the instrument for verifying the status of the account
Example:eyJhbGciOiJSUzI1NiJ9.eyJhY2NvdW50SGFzaCI6ImM5YWM2ZjFhZDhjNDA3Y2ZjNzMyNDljNTE2MTJjNTdmMWQxZGNiNTA4YjE4ZGJlYWE1MWQ0NDI5NjBjMjUwNDUyMzY4ZTg2YmUzMWQ3MDMxMDY4ZDM2MjM2NzVjYzhkYTUzNzhhODNmMTUwZjg5OTczOTBiZTEyMGU1ZmExN2RhIiwib25UZXN0Ijp0cnVlLCJzZXJ2aWNlIjoibW9jayIsImlkIjo0MDB9.dFMY4EwCrWq9EBmERFkKCoLHExPH4vgaCgnZaqB_mf8n3Sv6Qnu6Pb79onluX1OZecmYmBuHqZ_ykKXWSD4RMZSpckYFCiO3mlcJKI4qb91COhl_c2qXxYJuLEdbLfGlzf0k8-oJgFcO9gAS1Xm0hpTP4iiXF6st1hFwlfR3fpX4rr-bTsKgMvRSReMuxa0Vs92DykfqUR_3udlc0DFCPB9ZTaSqeRNHFAPAWNniUPWURQlW5c9J9xcyKTgKGzfI1_7h2I4ALQeRifptE2nC-HZtEMwtcToNh7hn0oL9lNFXnXGK9sWKORcyWKVfpEChS8z30UfX6kOhU6fp_qUwmA
Name
token
Type
Token
is optional
Description
Structure that contains the token information associated with the card. For entry, only the token or subtoken and the cvv are necessary if it is an operation where the user is present. For output if all data is returned when tokenizing.
Name
token
Type
string
is optional
Description
Code generated to identify the card in the system
Max length:64
Min length:64
Name
subtoken
Type
string
is optional
Description
Alternate code generated to identify the card
Max length:16
Min length:16
Name
franchise
Type
string
is optional
Description
Franchise code associated with the token (Only as a response, it is not necessary to send it)
Allowed values:visavisa_electronamexmastercodensadinersjbcdiscoverriscredencialcomfamacolsubsidiofalabellaelosomostuyaexitoalkostomaestromefiaath_card
Name
franchiseName
Type
string
is optional
Description
Name
issuerName
Type
string
is optional
Description
Name
lastDigits
Type
string
is optional
Description
Name
validUntil
Type
string
is optional
Description
Name
cvv
Type
string
is optional
Description
CVV requested from the user in case it is present in the operation
Max length:4
Min length:3
Name
credit
Type
Credit
is optional
Description
Structure that contains information on the type of credit
Name
code
Type
string
is optional
Description
Name
type
Type
string
is optional
Description
Name
groupCode
Type
string
is optional
Description
Name
installment
Type
integer
is optional
Description
Name
threeDS
Type
object
is optional
Description
Name
version
Type
string
is Required
REQUIRED
Description
Allowed values:v2v2x
Name
id
Type
number
is optional
Description
This value only applies if the validation was done with the Placetopay 3DS service
Name
enrolled
Type
string
is Required
REQUIRED
Description
Reports whether the card is registered in 3DS
Allowed values:YNU
Min length:1
Name
authenticated
Type
string
is Required
REQUIRED
Description
Allowed values:YNUAICDR
Max length:1
Min length:1
Name
eci
Type
string
is Required
REQUIRED
Description
Authentication result indicator generated by e-commerce.
Allowed values:020100050607
Min length:1
Name
cavv
Type
string
is Required
REQUIRED
Description
Authentication value for the franchise generated by the ACS. (3DS field authenticationValue).
Example:AJkBABIWcQAAAAM5FwIzdGiYeHM
Max length:28
Min length:28
Nullable:Yes
Name
xid
Type
string
is Required
REQUIRED
Description
DS Transaction ID (3DS dsTransID field).
Min length:1
Name
extra
Type
object
is optional
Description
Name
transStatusReason
Type
string
is optional
Description
Provides information about the status of the transaction.
Nullable:Yes
Name
acsTransId
Type
string
is optional
Description
Unique transaction identifier generated by the ACS.
Example:37a7b6e0-fd58-4e38-98de-79c70c526a47
Name
threeDSServerTransID
Type
string
is optional
Description
Unique transaction identifier generated by the 3DS Server.
Example:eadd3a60-b870-41d0-977f-921b3dbe6323/MkGJDl2Y5E=
Name
validSignature
Type
boolean
is optional
Description
Name
otp
Type
string
is optional
Description
Name
pinPad
Type
PinPad
is optional
Description
Structure containing PinPad service information
Name
transactionId
Type
string
is optional
Description
Name
positions
Type
string
is optional
Description
Name
pinBlock
Type
string
is optional
Description
Name
length
Type
integer
is optional
Description
Name
pin
Type
string
is optional
Description
Receives the PIN code when it is flat or when it is a PinBlock
Example:0B880E2326F6409E
Max length:20
Min length:2
Name
redirection
Type
Redirection
is optional
Description
It represents a redirect payment method, meaning that it requires the user to be sent to another URL to complete the process.
Name
paymentMethod
Type
string
is optional
Description
Allowed values:_PSE_BTNBCBTNBCPGEFT
Name
returnURL
Type
string
is optional
Description
URL so that once the payment process is completed, control is returned (when applicable)
Example:http://your-site.com/your-return-route
Format:uri
Max length:250
Name
processURL
Type
string
is optional
Description
URL to which the client must be sent to continue the process, it is provided by the service
Format:uri
Max length:250
Name
additional
Type
object
is optional
Description
Estructura para relacionar datos adicionales en el proceso.
Name
bankCode
Type
string
is optional
Description
Código que identifica al banco en la red.
Example:1007
Name
userType
Type
string
is optional
Description
Example:person
Name
kount
Type
Kount
is optional
Description
Manages specific information to use with the Kount risk filter
Name
session
Type
string
is Required
REQUIRED
Description
Identifier of this operation in Kount, it must be unique per transaction
Name
type
Type
string
is optional
Description
Describes the type of operation that is being handled in the session to define the additional fields to be sent
Allowed values:airlinesoat
Name
pocket
Type
string
is optional
Description
Card pocket used for payment
Name
id
Type
string
is Required
REQUIRED
Description
Identifier returned in the initial lookup on which the query is to be made.

Solicitud

POST

/gateway/mpi/query

curl -X "POST" https://api-co-dev.placetopay.ws/gateway/mpi/lookup \
-H "Content-Type: application/json" \
-d '{
    "auth": {
        "login":"6dd490faf9cb87a9862245da41170ff2",
        "tranKey":"pctsO4oT5kxwT8VTF2fsHBtFqr7LdgBjWhoHtHjRX1k=",
        "nonce":"NDNlZHQ5djQ3ZGs=",
        "seed":"2024-12-11T13:28:47-05:00"
    },
    "id": 263073
}'

Response

Name
status
Type
Status
is Required
REQUIRED
Description
Structure that contains information about a request or payment, informing its current status.
Name
status
Type
string
is optional
Description
Allowed values:OKFAILEDAPPROVEDAPPROVED_PARTIALPARTIAL_EXPIREDREJECTEDPENDINGPENDING_VALIDATIONPENDING_PROCESSREFUNDEDREVERSEDERRORUNKNOWNMANUALDISPUTE
Name
reason
Type
string
is optional
Description
Max length:4
Min length:1
Name
message
Type
string
is optional
Description
Name
date
Type
string
is optional
Description
Example:2021-09-21T09:34:48-05:00
Name
data
Type
object
is Required
REQUIRED
Description
Name
version
Type
string
is Required
REQUIRED
Description
Allowed values:v2v2x
Name
id
Type
number
is optional
Description
This value only applies if the validation was done with the Placetopay 3DS service
Name
enrolled
Type
string
is Required
REQUIRED
Description
Reports whether the card is registered in 3DS
Allowed values:YNU
Min length:1
Name
authenticated
Type
string
is Required
REQUIRED
Description
Allowed values:YNUAICDR
Max length:1
Min length:1
Name
eci
Type
string
is Required
REQUIRED
Description
Authentication result indicator generated by e-commerce.
Allowed values:020100050607
Min length:1
Name
cavv
Type
string
is Required
REQUIRED
Description
Authentication value for the franchise generated by the ACS. (3DS field authenticationValue).
Example:AJkBABIWcQAAAAM5FwIzdGiYeHM
Max length:28
Min length:28
Nullable:Yes
Name
xid
Type
string
is Required
REQUIRED
Description
DS Transaction ID (3DS dsTransID field).
Min length:1
Name
extra
Type
object
is optional
Description
Name
transStatusReason
Type
string
is optional
Description
Provides information about the status of the transaction.
Nullable:Yes
Name
acsTransId
Type
string
is optional
Description
Unique transaction identifier generated by the ACS.
Example:37a7b6e0-fd58-4e38-98de-79c70c526a47
Name
threeDSServerTransID
Type
string
is optional
Description
Unique transaction identifier generated by the 3DS Server.
Example:eadd3a60-b870-41d0-977f-921b3dbe6323/MkGJDl2Y5E=
Name
validSignature
Type
boolean
is optional
Description

Query Response

{
    "status": {
        "status": "OK",
        "reason": "00",
        "message": "La petición se ha procesado correctamente",
        "date": "2024-12-11T13:28:50-05:00"
    },
    "data": {
        "version": "v2x",
        "id": 263238,
        "enrolled": "Y",
        "authenticated": "Y",
        "eci": "05",
        "cavv": "AAAAAAAAAAAAAAAAAAAAAAAAAAA=",
        "xid": "3581b9b5-d6e1-4fad-abfd-0627061fde32",
        "extra": {
            "transStatusReason": null,
            "acsTransId": "0850e583-9367-4712-b065-5c05540251f9",
            "threeDSServerTransID": "273355c4-4ad7-476b-a3ed-77f094727b2b"
        },
        "validSignature": true
    }
}