Placetopay Docs

POST/gateway/process

Transaction processing

This service allows the payment to be made to the user's card, the parameters of the instrument are variables, if type of credit or OTP is not requested, it is not necessary to send these variables, payer is always required, buyer is optional but recommended.

Request

Name
action
Type
string
is optional
Description
This field should be sent when a check-in process is carried out, otherwise, it should not be sent in the request.
Allowed values:checkin
Name
locale
Type
string
is optional
Description
Example:es_CO
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
payer
Type
Person
is Required
REQUIRED
Description
Structure that reflects the information of a person involved in a transaction.
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
buyer
Type
Person
is optional
Description
Structure that reflects the information of a person involved in a transaction.
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
instrument
Type
Instrument
is Required
REQUIRED
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 Required
REQUIRED
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
additional
Type
object
is optional
Description
Dynamic Object Key Value of information that you want to save with the transaction. The following keys are NOT allowed: _accountNumber, userAgent, fingerprint, sourcePlatform, tokenizationID, trazabilyCode, transactionCycle, RequestId, PartnerAuthCode, onTest, threeDSEnrolled, threeDSAuthenticated. see more at Additional data
Name
metadata
Type
object
is optional
Description
Dynamic object key value of additional information that external services request to be executed.
Name
EBTDeliveryIndicator
Type
string
is optional
Description
Allowed values:DIRECT_DELIVERYCUSTOMER_PICKUPCOMMERCIAL_SHIPPINGOTHERNOT_AVAILABLE
Name
notificationURL
Type
string
is optional
Description
URL to which an HTTP notification with transaction information will be sent once the transaction has been processed. See more at Notification
Example:https://your-site.com/your-notification-path
Name
ipAddress
Type
string
is optional
Description
Name
userAgent
Type
string
is optional
Description
Example:Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36
Name
sourcePlatform
Type
string
is optional
Description

Solicitud

POST

/gateway/process

curl -X "POST" https://api-co-dev.placetopay.ws/gateway/information \
-H "Content-Type: application/json" \
-d '{
    "auth": {
        "login": "c4ca4238a0b923820dcc509a6f75849b",
        "tranKey": "cgqVhiaKSUSJmYQsXMsBqpfjz155nyKk54I66xyfuDI=",
        "nonce": "NjBhZTllMjZjYmQxYg==",
        "seed": "2021-05-26T14:14:46-05:00"
    },
    "payer": {
        "name": "Ms. Nelle Beahan DVM",
        "surname": "Spencer",
        "email": "[email protected]",
        "documentType": "CC",
        "document": "3154383838",
        "mobile": "3006108300"
    },
    "payment": {
        "reference": "TEST_20210526_141005",
        "description": "Cum vitae et consequatur quas adipisci ut rem.",
        "amount": {
            "currency": "COP",
            "total": "32030"
        }
    },
    "instrument": {
        "card": {
            "number": "36545400000008",
            "expiration": "12/20",
            "cvv": "123",
            "installments": "2"
        }
    },
    "ipAddress": "190.85.90.130",
    "userAgent": "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"
}'

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
date
Type
string
is optional
Description
Example:2021-09-20T21:51:59-05:00
Name
transactionDate
Type
string
is optional
Description
Example:2021-09-20T21:51:59-05:00
Name
internalReference
Type
number
is optional
Description
Name
reference
Type
string
is optional
Description
Min length:1
Name
paymentMethod
Type
string
is optional
Description
Min length:1
Name
franchise
Type
string
is optional
Description
Min length:1
Name
franchiseName
Type
string
is optional
Description
Example:Botón Aval
Min length:1
Name
issuerName
Type
string
is optional
Description
Name of the processing bank
Example:Banco Bogotá
Min length:1
Nullable:Yes
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
conversion
Type
AmountConversion
is optional
Description
Structure to define the conversion factor and values.
Name
from
Type
AmountBase
is optional
Description
Structure that represents an amount that defines the currency and the total.
Name
currency
Type
string
is optional
Description
Name
total
Type
number
is optional
Description
Name
to
Type
AmountBase
is optional
Description
Structure that represents an amount that defines the currency and the total.
Name
currency
Type
string
is optional
Description
Name
total
Type
number
is optional
Description
Name
factor
Type
number
is optional
Description
Name
authorization
Type
string
is optional
Description
Min length:1
Nullable:Yes
Name
receipt
Type
string
is optional
Description
Max length:16
Nullable:Yes
Name
type
Type
string
is optional
Description
Allowed values:AUTH_ONLY
Min length:1
Name
refunded
Type
boolean
is optional
Description
Name
lastDigits
Type
string
is optional
Description
Min length:1
Nullable:Yes
Name
provider
Type
string
is optional
Description
Allowed values:ACHATH-AVALNETATH-MOVILAUSTROAVALBANCOLOMBIABRASPAGCOMFANDICREDIBANCODATAFASTEBUSEVERTECFLAMINGOINTERDINMEDIANETPAYSTUDIOREDEBANSABRESUPERGIROSTECNICARDTRANSERVERTUYA-DIRECT
Name
discount
Type
string
is optional
Description
Nullable:Yes
Name
processorFields
Type
object
is optional
Description
Name
id
Type
string
is optional
Description
Example:e67122e3b9af1f7f72eacd430996d94b
Name
b24
Type
string
is optional
Description
Example:?-
Name
paymentURL
Type
string
is optional
Description
Example:https://avalpaycenter.labdigbdbstgpb.com/?trazabilityCode=000000437981
Name
additional
Type
object
is optional
Description
See more at Additional data
Name
merchantCode
Type
string
is optional
Description
Entity code
Name
terminalNumber
Type
string
is optional
Description
Payment method terminal number
Name
trazabilyCode
Type
string
is optional
Description
Name
_wcTransactionId_
Type
string
is optional
Description
Transaction identifier in commerce
Name
preAuthorization
Type
object
is optional
Description
Name
condition
Type
string
is optional
Description
Name
internalReference
Type
number
is optional
Description
Name
authorization
Type
string
is optional
Description
Min length:1
Nullable:Yes
Name
receipt
Type
string
is optional
Description
Min length:1
Nullable:Yes
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
salt
Type
string
is optional
Description
Name
dispersion
Type
array
is optional
Description
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
agreement
Type
integer
is optional
Description
Nullable:Yes
Name
agreementType
Type
string
is optional
Description
Allowed values:AIRLINEMERCHANT
Name
authorization
Type
string
is optional
Description
Min length:1
Nullable:Yes
Name
receipt
Type
string
is optional
Description
Min length:1
Nullable:Yes
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
refunded
Type
boolean
is optional
Description
Name
paymentMethod
Type
string
is optional
Description
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
notificationURL
Type
string
is optional
Description
URL to which an HTTP notification with transaction information will be sent once the transaction has been processed. See more at Notification
Example:https://your-site.com/your-notification-path

Respuesta

    {
        "status": {
            "status": "APPROVED",
            "reason": "00",
            "message": "Aprobada",
            "date": "2021-09-24T11:51:31-05:00"
        },
        "date": "2021-09-24T11:51:31-05:00",
        "transactionDate": "2021-09-24T11:51:31-05:00",
        "internalReference": 41,
        "reference": "ON1434012-PN1433129",
        "paymentMethod": "CR_VS",
        "franchise": "visa",
        "franchiseName": "Visa",
        "issuerName": "BANCO DE GUAYAQUIL, S.A.",
        "amount": {
            "taxes": [
            {
                "kind": "airportTax",
                "amount": 63,
                "base": 0
            },
            {
                "kind": "valueAddedTax",
                "amount": 158.47,
                "base": 0
            }
            ],
            "currency": "USD",
            "total": 1161.12
        },
        "conversion": {
            "from": {
            "currency": "USD",
            "total": 1161.12
            },
            "to": {
            "currency": "USD",
            "total": 1161
            },
            "factor": 1
        },
        "authorization": "739877",
        "receipt": "713329175945",
        "type": "DISPERSION",
        "refunded": false,
        "lastDigits": "0032",
        "provider": "CREDIBANCO",
        "discount": null,
        "processorFields": {
            "id": "08c0284b20510c8db8dcb29137374718",
            "b24": "XX"
        },
        "additional": {
            "merchantCode": "123456",
            "terminalNumber": "12345678",
            "bin": "411076",
            "expiration": "1220"
        },
        "dispersion": [
            {
            "status": {
                "status": "APPROVED",
                "reason": "00",
                "message": "Transacción aprobada",
                "date": "2021-09-24T11:51:31-05:00"
            },
            "agreement": 1,
            "type": "AIRLINE",
            "authorization": "739877",
            "receipt": "713329175945",
            "amount": {
                "currency": "CLP",
                "total": 638155.3
            },
            "refunded": false,
            "paymentMethod": "PS_VS"
            },
            {
            "status": {
                "status": "APPROVED",
                "reason": "00",
                "message": "Transacción aprobada",
                "date": "2021-09-24T11:51:31-05:00"
            },
            "agreement": null,
            "type": "MERCHANT",
            "authorization": "000000",
            "receipt": null,
            "amount": {
                "currency": "COP",
                "total": 297580
            },
            "refunded": false,
            "paymentMethod": "CR_VS"
            }
        ]
    }

POST/gateway/query

Transaction query by internal reference

Allows you to consult a particular transaction using its internal reference.

Request

Name
locale
Type
string
is optional
Description
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
internalReference
Type
number
is Required
REQUIRED
Description

Solicitud

POST

/gateway/query

curl -X "POST" https://api-co-dev.placetopay.ws/gateway/query \
-H "Content-Type: application/json" \
-d '{
    "locale": "es_CO",
    "auth": {
        "login":"c51ce410c124a10e0db5e4b97fc2af39",
        "tranKey":"VQOcRcVH2DfL6Y4B4SaK6yhoH/VOUveZ3xT16OQnvxE=",
        "nonce":"NjE0OWVkODgwYjNhNw==",
        "seed":"2021-09-21T09:34:48-05:00"
    },
    "internalReference": "230364"
}'

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
date
Type
string
is optional
Description
EJ: 2021-09-20T21:51:59-05:00
Name
transactionDate
Type
string
is optional
Description
EJ: 2021-09-20T21:51:59-05:00
Name
internalReference
Type
number
is Required
REQUIRED
Description
Name
reference
Type
string
is Required
REQUIRED
Description
Min length:1
Name
paymentMethod
Type
string
is Required
REQUIRED
Description
Min length:1
Name
franchise
Type
string
is Required
REQUIRED
Description
Min length:1
Name
franchiseName
Type
string
is Required
REQUIRED
Description
Min length:1
Name
issuerName
Type
string
is Required
REQUIRED
Description
Min length:1
Nullable:Yes
Name
amount
Type
Amount
is Required
REQUIRED
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
conversion
Type
AmountConversion
is Required
REQUIRED
Description
Structure to define the conversion factor and values.
Name
from
Type
AmountBase
is optional
Description
Structure that represents an amount that defines the currency and the total.
Name
currency
Type
string
is optional
Description
Name
total
Type
number
is optional
Description
Name
to
Type
AmountBase
is optional
Description
Structure that represents an amount that defines the currency and the total.
Name
currency
Type
string
is optional
Description
Name
total
Type
number
is optional
Description
Name
factor
Type
number
is optional
Description
Name
authorization
Type
string
is Required
REQUIRED
Description
Min length:1
Nullable:Yes
Name
receipt
Type
string
is Required
REQUIRED
Description
Max length:16
Nullable:Yes
Name
type
Type
string
is Required
REQUIRED
Description
Min length:1
Name
refunded
Type
boolean
is Required
REQUIRED
Description
Name
lastDigits
Type
string
is Required
REQUIRED
Description
Min length:1
Nullable:Yes
Name
provider
Type
string
is Required
REQUIRED
Description
Allowed values:CREDIBANCOREDEBANINTERDINDATAFASTTUYA-DIRECTBRASPAGTRANSERVERSABREEVERTECACHATH-AVALNETSUPERGIROSTECNICARDMEDIANETAUSTROCOMFANDIPAYSTUDIOFLAMINGOATH-MOVILEBUSBANCOLOMBIA
Name
discount
Type
string
is Required
REQUIRED
Description
Name
processorFields
Type
object
is Required
REQUIRED
Description
Name
id
Type
string
is optional
Description
Name
b24
Type
string
is optional
Description
Name
additional
Type
object
is Required
REQUIRED
Description
See more in Additional data
Name
preAuthorization
Type
object
is optional
Description
Name
condition
Type
string
is optional
Description
Name
internalReference
Type
number
is optional
Description
Name
authorization
Type
string
is optional
Description
Min length:1
Nullable:Yes
Name
receipt
Type
string
is optional
Description
Min length:1
Nullable:Yes
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
salt
Type
string
is optional
Description
Name
dispersion
Type
array
is optional
Description
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
agreement
Type
integer
is optional
Description
Nullable:Yes
Name
agreementType
Type
string
is optional
Description
Allowed values:AIRLINEMERCHANT
Name
authorization
Type
string
is optional
Description
Min length:1
Nullable:Yes
Name
receipt
Type
string
is optional
Description
Min length:1
Nullable:Yes
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
refunded
Type
boolean
is optional
Description
Name
paymentMethod
Type
string
is optional
Description

Respuesta

{
    "status": {
        "status": "APPROVED",
        "reason": "00",
        "message": "Aprobada",
        "date": "2021-09-24T14:04:23-05:00"
    },
    "date": "2021-09-24T10:02:17-05:00",
    "transactionDate": "2021-09-24T10:02:18-05:00",
    "internalReference": 230364,
    "reference": "800166551",
    "paymentMethod": "ID_DN",
    "franchise": "diners",
    "franchiseName": "Diners",
    "issuerName": "Diners",
    "amount": {
        "taxes": [
        {
            "kind": "valueAddedTax",
            "amount": 0,
            "base": 0
        }
        ],
        "currency": "USD",
        "total": 120
    },
    "conversion": {
        "from": {
        "currency": "USD",
        "total": 120
        },
        "to": {
        "currency": "USD",
        "total": 120
        },
        "factor": 1
    },
    "authorization": "999999",
    "receipt": "230364",
    "type": "AUTH_ONLY",
    "refunded": false,
    "lastDigits": "0008",
    "provider": "INTERDIN",
    "discount": null,
    "processorFields": {
        "id": "cf3e77878a07d6e3ee667c60081dc39d",
        "b24": "00"
    },
    "additional": {
        "merchantCode": "1065152",
        "terminalNumber": "00990099",
        "credit": {
        "code": 1,
        "type": "03",
        "groupCode": "X",
        "installments": 3
        },
        "totalAmount": 120,
        "interestAmount": 0,
        "installmentAmount": 40,
        "iceAmount": 0,
        "batch": null,
        "line": null,
        "bin": "365454",
        "expiration": "1122"
    },
    "notificationURL": "https://test.placetopay.ec/redirection/api/notify"
}

POST/gateway/search

Transaction search

This service allows the search for transactions by reference and amount, it is usually used in case of loss of communication when creating a transaction to obtain the internal reference again.

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
reference
Type
string
is Required
REQUIRED
Description
Min length:1
Name
amount
Type
Amount
is Required
REQUIRED
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

Solicitud

POST

/gateway/search

curl -X "POST" https://api-co-dev.placetopay.ws/gateway/search \
-H "Content-Type: application/json" \
-d '{
    "locale": "es_CO",
    "auth": {
        "login":"c51ce410c124a10e0db5e4b97fc2af39",
        "tranKey":"VQOcRcVH2DfL6Y4B4SaK6yhoH/VOUveZ3xT16OQnvxE=",
        "nonce":"NjE0OWVkODgwYjNhNw==",
        "seed":"2021-09-21T09:34:48-05:00"
    },
    "reference": "TEST_20171108_144400"
    "amount": {
        "currency": "COP",
        "total": "1000"
    }
}'

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
transactions
Type
array
is Required
REQUIRED
Description
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
date
Type
string
is optional
Description
EJ: 2021-09-20T21:51:59-05:00
Name
transactionDate
Type
string
is optional
Description
EJ: 2021-09-20T21:51:59-05:00
Name
internalReference
Type
number
is Required
REQUIRED
Description
Name
reference
Type
string
is Required
REQUIRED
Description
Min length:1
Name
paymentMethod
Type
string
is Required
REQUIRED
Description
Min length:1
Name
franchise
Type
string
is Required
REQUIRED
Description
Min length:1
Name
franchiseName
Type
string
is Required
REQUIRED
Description
Min length:1
Name
issuerName
Type
string
is Required
REQUIRED
Description
Min length:1
Nullable:Yes
Name
amount
Type
Amount
is Required
REQUIRED
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
conversion
Type
AmountConversion
is Required
REQUIRED
Description
Structure to define the conversion factor and values.
Name
from
Type
AmountBase
is optional
Description
Structure that represents an amount that defines the currency and the total.
Name
currency
Type
string
is optional
Description
Name
total
Type
number
is optional
Description
Name
to
Type
AmountBase
is optional
Description
Structure that represents an amount that defines the currency and the total.
Name
currency
Type
string
is optional
Description
Name
total
Type
number
is optional
Description
Name
factor
Type
number
is optional
Description
Name
authorization
Type
string
is Required
REQUIRED
Description
Min length:1
Nullable:Yes
Name
receipt
Type
string
is Required
REQUIRED
Description
Max length:16
Nullable:Yes
Name
type
Type
string
is Required
REQUIRED
Description
Min length:1
Name
refunded
Type
boolean
is Required
REQUIRED
Description
Name
lastDigits
Type
string
is Required
REQUIRED
Description
Min length:1
Nullable:Yes
Name
provider
Type
string
is Required
REQUIRED
Description
Allowed values:CREDIBANCOREDEBANINTERDINDATAFASTTUYA-DIRECTBRASPAGTRANSERVERSABREEVERTECACHATH-AVALNETSUPERGIROSTECNICARDMEDIANETAUSTROCOMFANDIPAYSTUDIOFLAMINGOATH-MOVILEBUSBANCOLOMBIA
Name
discount
Type
string
is Required
REQUIRED
Description
Name
processorFields
Type
object
is Required
REQUIRED
Description
Name
id
Type
string
is optional
Description
Name
b24
Type
string
is optional
Description
Name
additional
Type
object
is Required
REQUIRED
Description
See more in Additional data
Name
preAuthorization
Type
object
is optional
Description
Name
condition
Type
string
is optional
Description
Name
internalReference
Type
number
is optional
Description
Name
authorization
Type
string
is optional
Description
Min length:1
Nullable:Yes
Name
receipt
Type
string
is optional
Description
Min length:1
Nullable:Yes
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
salt
Type
string
is optional
Description
Name
dispersion
Type
array
is optional
Description
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
agreement
Type
integer
is optional
Description
Nullable:Yes
Name
agreementType
Type
string
is optional
Description
Allowed values:AIRLINEMERCHANT
Name
authorization
Type
string
is optional
Description
Min length:1
Nullable:Yes
Name
receipt
Type
string
is optional
Description
Min length:1
Nullable:Yes
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
refunded
Type
boolean
is optional
Description
Name
paymentMethod
Type
string
is optional
Description

Respuesta

{
    "status": {
        "status": "OK",
        "reason": "00",
        "message": "La petición se ha procesado correctamente",
        "date": "2021-09-20T21:51:59-05:00"
    },
    "transactions": [
        {
        "status": {
            "status": "PENDING",
            "reason": "?-",
            "message": "Transacción pendiente",
            "date": "2021-09-20T21:51:59-05:00"
        },
        "date": "2021-09-20T21:51:59-05:00",
        "transactionDate": "2021-09-20T21:51:59-05:00",
        "internalReference": 453,
        "reference": "TEST_3",
        "paymentMethod": "ID_VS",
        "franchise": "visa",
        "franchiseName": "Visa",
        "issuerName": "Testing Bank",
        "amount": {
            "taxes": [
            {
                "kind": "valueAddedTax",
                "amount": 3.27,
                "base": 0
            }
            ],
            "currency": "USD",
            "total": 17.2
        },
        "conversion": {
            "from": {
            "currency": "USD",
            "total": 17.2
            },
            "to": {
            "currency": "USD",
            "total": 17.2
            },
            "factor": 1
        },
        "authorization": null,
        "receipt": null,
        "type": "AUTH_ONLY",
        "refunded": false,
        "lastDigits": "0008",
        "provider": "INTERDIN",
        "discount": null,
        "processorFields": {
            "id": "a9cb4b7a7aa03f681a0545ba6807e1fc",
            "b24": "?-"
        },
        "additional": {
            "merchantCode": "000468232",
            "terminalNumber": "00990101",
            "credit": null,
            "totalAmount": 17.2,
            "interestAmount": 0,
            "installmentAmount": 0,
            "iceAmount": 0,
            "batch": null,
            "line": null,
            "bin": "411076",
            "expiration": "1228"
        }
        },
        {
        "status": {
            "status": "PENDING",
            "reason": "?-",
            "message": "Transacción pendiente",
            "date": "2021-09-20T21:51:59-05:00"
        },
        "date": "2021-09-20T21:51:59-05:00",
        "transactionDate": "2021-09-20T21:51:59-05:00",
        "internalReference": 452,
        "reference": "TEST_3",
        "paymentMethod": "ID_VS",
        "franchise": "visa",
        "franchiseName": "Visa",
        "issuerName": "Testing Bank",
        "amount": {
            "taxes": [
            {
                "kind": "valueAddedTax",
                "amount": 3.27,
                "base": 0
            }
            ],
            "details": [
            {
                "kind": "shipping",
                "amount": 100
            }
            ],
            "currency": "USD",
            "total": 17.2
        },
        "conversion": {
            "from": {
            "currency": "USD",
            "total": 17.2
            },
            "to": {
            "currency": "USD",
            "total": 17.2
            },
            "factor": 1
        },
        "authorization": null,
        "receipt": null,
        "type": "AUTH_ONLY",
        "refunded": false,
        "lastDigits": "0008",
        "provider": "INTERDIN",
        "discount": null,
        "processorFields": {
            "id": "cbc65da9667ca078dc774cad2fd510e4",
            "b24": "?-"
        },
        "additional": {
            "merchantCode": "000468232",
            "terminalNumber": "00990101",
            "credit": null,
            "totalAmount": 17.2,
            "interestAmount": 0,
            "installmentAmount": 0,
            "iceAmount": 0,
            "batch": null,
            "line": null,
            "bin": "411076",
            "expiration": "1228"
        }
        }
    ]
}

POST/gateway/transaction

Operations on a transaction

Allows you to perform a reversal, re-authorization, refund or checkout on an existing transaction

Request

Name
locale
Type
string
is optional
Description
Example:es-CO
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
action
Type
string
is Required
REQUIRED
Description
Type of operation to be performed on the transaction

reverse to reverse a transaction. reauthorization to modify a checkin transaction. checkout to close and collect a checkin transaction. refund to refund a transaction. process, to manually approve a transaction. void to cancel processing of a transaction pending manual approval.
Allowed values:reverserefundprocessvoiddispersioncheckoutreauthorization
Example:reverse
Name
internalReference
Type
number
is Required
REQUIRED
Description
Unique internal transaction reference

EJ: 543423
Name
authorization
Type
string
is optional
Description
Transaction Authorization

EJ: 9999999
Name
payment
Type
object
is optional
Description
Structure that contains information about the payment of the transaction
Name
amount
Type
object
is optional
Description
Name
currency
Type
number
is optional
Description
Alphabetical code of the currency to use (ISO 4217 alpha code)

EJ: USD
Name
total
Type
number
is optional
Description
Total value in indicated base currency

EJ: 1000 Total value in indicated base currency

Solicitud

POST

/gateway/transaction

    curl -X "POST" https://api-co-dev.placetopay.ws/gateway/transaction \
        -H "Content-Type: application/json" \
        -d "{
            "auth": {
                "login": "c51ce410c124a10e0db5e4b97fc2af39",
                "tranKey": "VQOcRcVH2DfL6Y4B4SaK6yhoH/VOUveZ3xT16OQnvxE=",
                "nonce": "NjE0OWVkODgwYjNhNw==",
                "seed": "2021-09-21T09:34:48-05:00"
            },
            "internalReference": "1505723583",
            "authorization": "999999"
            "action": "reverse",
        }"

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
date
Type
string
is optional
Description
EJ: 2021-09-20T21:51:59-05:00
Name
transactionDate
Type
string
is optional
Description
EJ: 2021-09-20T21:51:59-05:00
Name
internalReference
Type
number
is Required
REQUIRED
Description
Name
reference
Type
string
is Required
REQUIRED
Description
Min length:1
Name
paymentMethod
Type
string
is Required
REQUIRED
Description
Min length:1
Name
franchise
Type
string
is Required
REQUIRED
Description
Min length:1
Name
franchiseName
Type
string
is Required
REQUIRED
Description
Min length:1
Name
issuerName
Type
string
is Required
REQUIRED
Description
Min length:1
Nullable:Yes
Name
amount
Type
Amount
is Required
REQUIRED
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
conversion
Type
AmountConversion
is Required
REQUIRED
Description
Structure to define the conversion factor and values.
Name
from
Type
AmountBase
is optional
Description
Structure that represents an amount that defines the currency and the total.
Name
currency
Type
string
is optional
Description
Name
total
Type
number
is optional
Description
Name
to
Type
AmountBase
is optional
Description
Structure that represents an amount that defines the currency and the total.
Name
currency
Type
string
is optional
Description
Name
total
Type
number
is optional
Description
Name
factor
Type
number
is optional
Description
Name
authorization
Type
string
is Required
REQUIRED
Description
Min length:1
Nullable:Yes
Name
receipt
Type
string
is Required
REQUIRED
Description
Max length:16
Nullable:Yes
Name
type
Type
string
is Required
REQUIRED
Description
Min length:1
Name
refunded
Type
boolean
is Required
REQUIRED
Description
Name
lastDigits
Type
string
is Required
REQUIRED
Description
Min length:1
Nullable:Yes
Name
provider
Type
string
is Required
REQUIRED
Description
Allowed values:CREDIBANCOREDEBANINTERDINDATAFASTTUYA-DIRECTBRASPAGTRANSERVERSABREEVERTECACHATH-AVALNETSUPERGIROSTECNICARDMEDIANETAUSTROCOMFANDIPAYSTUDIOFLAMINGOATH-MOVILEBUSBANCOLOMBIA
Name
discount
Type
string
is Required
REQUIRED
Description
Name
processorFields
Type
object
is Required
REQUIRED
Description
Name
id
Type
string
is optional
Description
Name
b24
Type
string
is optional
Description
Name
additional
Type
object
is Required
REQUIRED
Description
See more in Additional data
Name
preAuthorization
Type
object
is optional
Description
Name
condition
Type
string
is optional
Description
Name
internalReference
Type
number
is optional
Description
Name
authorization
Type
string
is optional
Description
Min length:1
Nullable:Yes
Name
receipt
Type
string
is optional
Description
Min length:1
Nullable:Yes
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
salt
Type
string
is optional
Description
Name
dispersion
Type
array
is optional
Description
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
agreement
Type
integer
is optional
Description
Nullable:Yes
Name
agreementType
Type
string
is optional
Description
Allowed values:AIRLINEMERCHANT
Name
authorization
Type
string
is optional
Description
Min length:1
Nullable:Yes
Name
receipt
Type
string
is optional
Description
Min length:1
Nullable:Yes
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
refunded
Type
boolean
is optional
Description
Name
paymentMethod
Type
string
is optional
Description

Respuesta

    {
        "status": {
            "status": "APPROVED",
            "reason": "00",
            "message": "Aprobada",
            "date": "2024-09-25T14:17:56-05:00"
        },
        "date": "2024-09-25T14:17:53-05:00",
        "transactionDate": "2024-09-25T14:17:56-05:00",
        "internalReference": 9,
        "reference": "331122",
        "paymentMethod": "CR_VS",
        "franchise": "visa",
        "franchiseName": "Visa",
        "issuerName": "JPMORGAN CHASE BANK, N.A.",
        "amount": {
            "taxes": [
                {
                    "kind": "valueAddedTax",
                    "amount": 0,
                    "base": 0
                }
            ],
            "currency": "COP",
            "total": 20000
        },
        "conversion": {
            "from": {
                "currency": "COP",
                "total": 20000
            },
            "to": {
                "currency": "COP",
                "total": 20000
            },
            "factor": 1
        },
        "authorization": "000000",
        "receipt": null,
        "type": "CREDIT",
        "refunded": false,
        "lastDigits": "1111",
        "provider": "CREDIBANCO",
        "discount": null,
        "processorFields": {
            "id": "0aba335e6b5a67822150e27f98949b3a",
            "b24": "000"
        },
        "additional": {
            "merchantCode": "012988341",
            "terminalNumber": "00022645",
            "bin": "411111",
            "expiration": "0525",
            "installments": 1
        }
    }