Queries API

Queries API lets you check the status of the placed orders along with their transactions.

To integrate with Queries API, target your request to the following URLs according to your environment.

Available methods

Queries API includes the following methods:

Query by Order Id

Order Id is a value generated by PayU to identify all the transactions generated for a payment request performed by your customer. You can use the ORDER_DETAIL command to consult the status of an Order by its identifier.

The following are the request and response examples for this operation.


Request example:

{
   "test": false,
   "language": "en",
   "command": "ORDER_DETAIL",
   "merchant": {
      "apiLogin": "pRRXKOl8ikMmt9u",
      "apiKey": "4Vj8eK4rloUd272L48hsrarnUA"
   },
   "details": {
      "orderId": 857695047
   }
}

Response example:

{
    "code": "SUCCESS",
    "error": null,
    "result": {
        "payload": {
            "id": 857695047,
            "accountId": 512321,
            "status": "CAPTURED",
            "referenceCode": "PRODUCT_TEST_2021-05-03T18:01:10.946Z",
            "description": "Payment test description Documentation",
            "airlineCode": null,
            "language": "es",
            "notifyUrl": "http://www.payulatam.com/confirmation",
            "shippingAddress": {
                "street1": "calle 100",
                "street2": "5555487",
                "city": "Medellin",
                "state": "Antioquia",
                "country": "CO",
                "postalCode": "0000000",
                "phone": "7563126"
            },
            "buyer": {
                "merchantBuyerId": "1",
                "fullName": "First name and second buyer name",
                "emailAddress": "buyer_test@test.com",
                "contactPhone": "7563126",
                "buyerAddress": {
                    "street1": "calle 100",
                    "street2": "5555487",
                    "city": "Medellin",
                    "state": "Antioquia",
                    "country": "CO",
                    "postalCode": "000000",
                    "phone": "7563126"
                },
                "dniNumber": "123456789",
                "cnpj": null
            },
            "antifraudMerchantId": null,
            "isTest": true,
            "transactions": [
                {
                    "id": "5fde3c2c-540d-4579-96f7-2a4b8c65a951",
                    "order": null,
                    "creditCard": {
                        "maskedNumber": "547130******0003",
                        "issuerBank": null,
                        "name": "APPROVED",
                        "cardType": null
                    },
                    "bankAccount": null,
                    "type": "AUTHORIZATION_AND_CAPTURE",
                    "parentTransactionId": null,
                    "paymentMethod": "MASTERCARD",
                    "source": null,
                    "paymentCountry": "CO",
                    "transactionResponse": {
                        "state": "APPROVED",
                        "paymentNetworkResponseCode": null,
                        "paymentNetworkResponseErrorMessage": null,
                        "trazabilityCode": "00000000",
                        "authorizationCode": "00000000",
                        "pendingReason": null,
                        "responseCode": "APPROVED",
                        "errorCode": null,
                        "responseMessage": null,
                        "transactionDate": null,
                        "transactionTime": null,
                        "operationDate": 1620064792953,
                        "extraParameters": null
                    },
                    "deviceSessionId": "vghs6tvkcle931686k1900o6e1",
                    "ipAddress": "127.0.0.1",
                    "cookie": "pt1t38347bs6jc9ruv2ecpv7o2",
                    "userAgent": "Mozilla/5.0 (Windows NT 5.1; rv:18.0) Gecko/20100101 Firefox/18.0",
                    "expirationDate": null,
                    "payer": {
                        "merchantPayerId": "1",
                        "fullName": "First name and second payer name",
                        "billingAddress": {
                            "street1": "calle 93",
                            "street2": "125544",
                            "city": "Bogota",
                            "state": "Bogota DC",
                            "country": "CO",
                            "postalCode": "000000",
                            "phone": "7563126"
                        },
                        "emailAddress": "payer_test@test.com",
                        "contactPhone": "7563126",
                        "dniNumber": "5415668464654",
                        "dniType": null
                    },
                    "termsAndConditionId": 202,
                    "additionalValues": {
                        "PM_PAYER_COMMISSION_VALUE": {
                            "value": 0.00,
                            "currency": "COP"
                        },
                        "PM_PAYER_TOTAL_AMOUNT": {
                            "value": 50000.00,
                            "currency": "COP"
                        },
                        "PM_TAX": {
                            "value": 0.00,
                            "currency": "COP"
                        },
                        "PM_PAYER_INTEREST_VALUE": {
                            "value": 0.00,
                            "currency": "COP"
                        },
                        "TX_ADDITIONAL_VALUE": {
                            "value": 0.00,
                            "currency": "COP"
                        },
                        "PM_NETWORK_VALUE": {
                            "value": 50000.00,
                            "currency": "COP"
                        },
                        "PM_TAX_RETURN_BASE": {
                            "value": 0.00,
                            "currency": "COP"
                        },
                        "TX_VALUE": {
                            "value": 50000.00,
                            "currency": "COP"
                        },
                        "CURRENT_TX_VALUE": {
                            "value": 50000.00,
                            "currency": "COP"
                        },
                        "TX_TAX": {
                            "value": 0.00,
                            "currency": "COP"
                        },
                        "PM_PAYER_PRICING_VALUES": {
                            "value": 0.00,
                            "currency": "COP"
                        },
                        "TX_TAX_RETURN_BASE": {
                            "value": 0.00,
                            "currency": "COP"
                        },
                        "PM_PURCHASE_VALUE": {
                            "value": 50000.00,
                            "currency": "COP"
                        },
                        "PM_ADDITIONAL_VALUE": {
                            "value": 0.00,
                            "currency": "COP"
                        },
                        "PM_VALUE": {
                            "value": 50000.00,
                            "currency": "COP"
                        }
                    },
                    "extraParameters": {
                        "MIN_SHIPPING_PAYER": "0",
                        "BANK_REFERENCED_CODE": "CREDIT",
                        "PRICING_PROFILE_GROUP_ID": "MG-PRICING_2_341559",
                        "MAX_SHIPPING_MERCHANT": "0",
                        "PERCENT_SHIPPING_MERCHANT": "0",
                        "MAX_SHIPPING_PAYER": "0",
                        "MERCHANT_PROFILE_ID": "MG-PRICING_1_51803",
                        "MIN_SHIPPING_MERCHANT": "0",
                        "INSTALLMENTS_NUMBER": "1",
                        "PAYMENT_WAY_ID": "4"
                    }
                }
            ],
            "additionalValues": {
                "PM_PAYER_COMMISSION_VALUE": {
                    "value": 0.00,
                    "currency": "COP"
                },
                "PM_TAX": {
                    "value": 0.00,
                    "currency": "COP"
                },
                "PM_PAYER_INTEREST_VALUE": {
                    "value": 0.00,
                    "currency": "COP"
                },
                "TX_ADDITIONAL_VALUE": {
                    "value": 0.00,
                    "currency": "COP"
                },
                "PM_NETWORK_VALUE": {
                    "value": 50000.00,
                    "currency": "COP"
                },
                "PM_TAX_RETURN_BASE": {
                    "value": 0.00,
                    "currency": "COP"
                },
                "TX_VALUE": {
                    "value": 50000.00,
                    "currency": "COP"
                },
                "TX_TAX": {
                    "value": 0.00,
                    "currency": "COP"
                },
                "PM_PAYER_PRICING_VALUES": {
                    "value": 0.00,
                    "currency": "COP"
                },
                "TX_TAX_RETURN_BASE": {
                    "value": 0.00,
                    "currency": "COP"
                },
                "PM_PURCHASE_VALUE": {
                    "value": 50000.00,
                    "currency": "COP"
                },
                "PM_ADDITIONAL_VALUE": {
                    "value": 0.00,
                    "currency": "COP"
                },
                "PM_VALUE": {
                    "value": 50000.00,
                    "currency": "COP"
                }
            },
            "creationDate": 1620064873257,
            "isCreatedUsingStandardIntegrationParams": null,
            "merchantId": 508029,
            "processedTransactionId": "5fde3c2c-540d-4579-96f7-2a4b8c65a951",
            "orderSignature": "49f80210a72e9b7cafe9001338450bbb"
        }
    }
}

Request example:

<request>
   <language>en</language>
   <command>ORDER_DETAIL</command>
   <merchant>
      <apiLogin>pRRXKOl8ikMmt9u</apiLogin>
      <apiKey>4Vj8eK4rloUd272L48hsrarnUA</apiKey>
   </merchant>
   <details class="java.util.HashMap">
      <entry>
         <string>orderId</string>
         <object class="java.lang.Long">2637540</object>
      </entry>
   </details>  
   <isTest>false</isTest>
</request>

Response example:

<reportingResponse>
    <code>SUCCESS</code>
    <result>
        <payload class="order">
            <id>857695047</id>
            <accountId>512321</accountId>
            <status>CAPTURED</status>
            <referenceCode>PRODUCT_TEST_2021-05-03T18:01:10.946Z</referenceCode>
            <description>Payment test description Documentation</description>
            <language>es</language>
            <notifyUrl>http://www.payulatam.com/confirmation</notifyUrl>
            <shippingAddress>
                <street1>calle 100</street1>
                <street2>5555487</street2>
                <city>Medellin</city>
                <state>Antioquia</state>
                <country>CO</country>
                <postalCode>0000000</postalCode>
                <phone>7563126</phone>
            </shippingAddress>
            <buyer>
                <merchantBuyerId>1</merchantBuyerId>
                <fullName>First name and second buyer name</fullName>
                <emailAddress>buyer_test@test.com</emailAddress>
                <contactPhone>7563126</contactPhone>
                <buyerAddress>
                    <street1>calle 100</street1>
                    <street2>5555487</street2>
                    <city>Medellin</city>
                    <state>Antioquia</state>
                    <country>CO</country>
                    <postalCode>000000</postalCode>
                    <phone>7563126</phone>
                </buyerAddress>
                <dniNumber>123456789</dniNumber>
            </buyer>
            <isTest>true</isTest>
            <transactions>
                <transaction>
                    <id>5fde3c2c-540d-4579-96f7-2a4b8c65a951</id>
                    <creditCard>
                        <maskedNumber>547130******0003</maskedNumber>
                        <name>APPROVED</name>
                    </creditCard>
                    <type>AUTHORIZATION_AND_CAPTURE</type>
                    <paymentMethod>MASTERCARD</paymentMethod>
                    <paymentCountry>CO</paymentCountry>
                    <transactionResponse>
                        <state>APPROVED</state>
                        <trazabilityCode>00000000</trazabilityCode>
                        <authorizationCode>00000000</authorizationCode>
                        <responseCode>APPROVED</responseCode>
                        <operationDate>2021-05-03T12:59:52</operationDate>
                    </transactionResponse>
                    <deviceSessionId>vghs6tvkcle931686k1900o6e1</deviceSessionId>
                    <ipAddress>127.0.0.1</ipAddress>
                    <cookie>pt1t38347bs6jc9ruv2ecpv7o2</cookie>
                    <userAgent>Mozilla/5.0 (Windows NT 5.1; rv:18.0) Gecko/20100101 Firefox/18.0</userAgent>
                    <payer>
                        <merchantPayerId>1</merchantPayerId>
                        <fullName>First name and second payer name</fullName>
                        <billingAddress>
                            <street1>calle 93</street1>
                            <street2>125544</street2>
                            <city>Bogota</city>
                            <state>Bogota DC</state>
                            <country>CO</country>
                            <postalCode>000000</postalCode>
                            <phone>7563126</phone>
                        </billingAddress>
                        <emailAddress>payer_test@test.com</emailAddress>
                        <contactPhone>7563126</contactPhone>
                        <dniNumber>5415668464654</dniNumber>
                    </payer>
                    <termsAndConditionId>202</termsAndConditionId>
                    <additionalValues>
                        <entry>
                            <string>PM_PAYER_COMMISSION_VALUE</string>
                            <additionalValue>
                                <value>0.00</value>
                                <currency>COP</currency>
                            </additionalValue>
                        </entry>
                        <entry>
                            <string>PM_PAYER_TOTAL_AMOUNT</string>
                            <additionalValue>
                                <value>50000.00</value>
                                <currency>COP</currency>
                            </additionalValue>
                        </entry>
                        <entry>
                            <string>PM_TAX</string>
                            <additionalValue>
                                <value>0.00</value>
                                <currency>COP</currency>
                            </additionalValue>
                        </entry>
                        <entry>
                            <string>PM_PAYER_INTEREST_VALUE</string>
                            <additionalValue>
                                <value>0.00</value>
                                <currency>COP</currency>
                            </additionalValue>
                        </entry>
                        <entry>
                            <string>TX_ADDITIONAL_VALUE</string>
                            <additionalValue>
                                <value>0.00</value>
                                <currency>COP</currency>
                            </additionalValue>
                        </entry>
                        <entry>
                            <string>PM_NETWORK_VALUE</string>
                            <additionalValue>
                                <value>50000.00</value>
                                <currency>COP</currency>
                            </additionalValue>
                        </entry>
                        <entry>
                            <string>PM_TAX_RETURN_BASE</string>
                            <additionalValue>
                                <value>0.00</value>
                                <currency>COP</currency>
                            </additionalValue>
                        </entry>
                        <entry>
                            <string>TX_VALUE</string>
                            <additionalValue>
                                <value>50000.00</value>
                                <currency>COP</currency>
                            </additionalValue>
                        </entry>
                        <entry>
                            <string>CURRENT_TX_VALUE</string>
                            <additionalValue>
                                <value>50000.00</value>
                                <currency>COP</currency>
                            </additionalValue>
                        </entry>
                        <entry>
                            <string>TX_TAX</string>
                            <additionalValue>
                                <value>0.00</value>
                                <currency>COP</currency>
                            </additionalValue>
                        </entry>
                        <entry>
                            <string>PM_PAYER_PRICING_VALUES</string>
                            <additionalValue>
                                <value>0.00</value>
                                <currency>COP</currency>
                            </additionalValue>
                        </entry>
                        <entry>
                            <string>TX_TAX_RETURN_BASE</string>
                            <additionalValue>
                                <value>0.00</value>
                                <currency>COP</currency>
                            </additionalValue>
                        </entry>
                        <entry>
                            <string>PM_PURCHASE_VALUE</string>
                            <additionalValue>
                                <value>50000.00</value>
                                <currency>COP</currency>
                            </additionalValue>
                        </entry>
                        <entry>
                            <string>PM_ADDITIONAL_VALUE</string>
                            <additionalValue>
                                <value>0.00</value>
                                <currency>COP</currency>
                            </additionalValue>
                        </entry>
                        <entry>
                            <string>PM_VALUE</string>
                            <additionalValue>
                                <value>50000.00</value>
                                <currency>COP</currency>
                            </additionalValue>
                        </entry>
                    </additionalValues>
                    <extraParameters>
                        <entry>
                            <string>MIN_SHIPPING_PAYER</string>
                            <string>0</string>
                        </entry>
                        <entry>
                            <string>BANK_REFERENCED_CODE</string>
                            <string>CREDIT</string>
                        </entry>
                        <entry>
                            <string>PRICING_PROFILE_GROUP_ID</string>
                            <string>MG-PRICING_2_341559</string>
                        </entry>
                        <entry>
                            <string>MAX_SHIPPING_MERCHANT</string>
                            <string>0</string>
                        </entry>
                        <entry>
                            <string>PERCENT_SHIPPING_MERCHANT</string>
                            <string>0</string>
                        </entry>
                        <entry>
                            <string>MAX_SHIPPING_PAYER</string>
                            <string>0</string>
                        </entry>
                        <entry>
                            <string>MERCHANT_PROFILE_ID</string>
                            <string>MG-PRICING_1_51803</string>
                        </entry>
                        <entry>
                            <string>MIN_SHIPPING_MERCHANT</string>
                            <string>0</string>
                        </entry>
                        <entry>
                            <string>INSTALLMENTS_NUMBER</string>
                            <string>1</string>
                        </entry>
                        <entry>
                            <string>PAYMENT_WAY_ID</string>
                            <string>4</string>
                        </entry>
                    </extraParameters>
                </transaction>
            </transactions>
            <additionalValues>
                <entry>
                    <string>PM_PAYER_COMMISSION_VALUE</string>
                    <additionalValue>
                        <value>0.00</value>
                        <currency>COP</currency>
                    </additionalValue>
                </entry>
                <entry>
                    <string>PM_TAX</string>
                    <additionalValue>
                        <value>0.00</value>
                        <currency>COP</currency>
                    </additionalValue>
                </entry>
                <entry>
                    <string>PM_PAYER_INTEREST_VALUE</string>
                    <additionalValue>
                        <value>0.00</value>
                        <currency>COP</currency>
                    </additionalValue>
                </entry>
                <entry>
                    <string>TX_ADDITIONAL_VALUE</string>
                    <additionalValue>
                        <value>0.00</value>
                        <currency>COP</currency>
                    </additionalValue>
                </entry>
                <entry>
                    <string>PM_NETWORK_VALUE</string>
                    <additionalValue>
                        <value>50000.00</value>
                        <currency>COP</currency>
                    </additionalValue>
                </entry>
                <entry>
                    <string>PM_TAX_RETURN_BASE</string>
                    <additionalValue>
                        <value>0.00</value>
                        <currency>COP</currency>
                    </additionalValue>
                </entry>
                <entry>
                    <string>TX_VALUE</string>
                    <additionalValue>
                        <value>50000.00</value>
                        <currency>COP</currency>
                    </additionalValue>
                </entry>
                <entry>
                    <string>TX_TAX</string>
                    <additionalValue>
                        <value>0.00</value>
                        <currency>COP</currency>
                    </additionalValue>
                </entry>
                <entry>
                    <string>PM_PAYER_PRICING_VALUES</string>
                    <additionalValue>
                        <value>0.00</value>
                        <currency>COP</currency>
                    </additionalValue>
                </entry>
                <entry>
                    <string>TX_TAX_RETURN_BASE</string>
                    <additionalValue>
                        <value>0.00</value>
                        <currency>COP</currency>
                    </additionalValue>
                </entry>
                <entry>
                    <string>PM_PURCHASE_VALUE</string>
                    <additionalValue>
                        <value>50000.00</value>
                        <currency>COP</currency>
                    </additionalValue>
                </entry>
                <entry>
                    <string>PM_ADDITIONAL_VALUE</string>
                    <additionalValue>
                        <value>0.00</value>
                        <currency>COP</currency>
                    </additionalValue>
                </entry>
                <entry>
                    <string>PM_VALUE</string>
                    <additionalValue>
                        <value>50000.00</value>
                        <currency>COP</currency>
                    </additionalValue>
                </entry>
            </additionalValues>
            <creationDate>2021-05-03T13:01:13</creationDate>
            <merchantId>508029</merchantId>
            <processedTransactionId>5fde3c2c-540d-4579-96f7-2a4b8c65a951</processedTransactionId>
            <orderSignature>49f80210a72e9b7cafe9001338450bbb</orderSignature>
        </payload>
    </result>
</reportingResponse>

Query by Transaction Id

Transaction Id is a value generated by PayU to identify one transaction generated for an order. You can use the TRANSACTION_RESPONSE_DETAIL command to consult the information of a given transaction.

The following are the request and response examples for this operation.


Request example:

{
   "test": false,
   "language": "en",
   "command": "TRANSACTION_RESPONSE_DETAIL",
   "merchant": {
      "apiLogin": "pRRXKOl8ikMmt9u",
      "apiKey": "4Vj8eK4rloUd272L48hsrarnUA"
   },
   "details": {
      "transactionId": "546e0fe9-8076-46b5-9f73-622c5a12f5cb"
   }
}

Response example:

{
    "code": "SUCCESS",
    "error": null,
    "result": {
        "payload": {
            "state": "APPROVED",
            "paymentNetworkResponseCode": "000",
            "paymentNetworkResponseErrorMessage": null,
            "trazabilityCode": "77821",
            "authorizationCode": "170921",
            "pendingReason": null,
            "responseCode": "APPROVED",
            "errorCode": null,
            "responseMessage": "Aprobado y completado con exito",
            "transactionDate": null,
            "transactionTime": null,
            "operationDate": 1620069958670,
            "extraParameters": null
        }
    }
}

Request example:

<request>
   <language>en</language>
   <command>TRANSACTION_RESPONSE_DETAIL</command>
   <merchant>
      <apiLogin>pRRXKOl8ikMmt9u</apiLogin>
      <apiKey>4Vj8eK4rloUd272L48hsrarnUA</apiKey>
   </merchant>
   <details class="java.util.HashMap">
      <entry>
         <string>transactionId</string>
         <object class="java.lang.String">546e0fe9-8076-46b5-9f73-622c5a12f5cb</object>
      </entry>
   </details>
   <isTest>false</isTest>
</request>

Response example:

<reportingResponse>
    <code>SUCCESS</code>
    <result>
        <payload class="transactionResponse">
            <state>APPROVED</state>
            <paymentNetworkResponseCode>000</paymentNetworkResponseCode>
            <trazabilityCode>77821</trazabilityCode>
            <authorizationCode>170921</authorizationCode>
            <responseCode>APPROVED</responseCode>
            <responseMessage>Aprobado y completado con exito</responseMessage>
            <operationDate>2021-05-03T14:25:58</operationDate>
        </payload>
    </result>
</reportingResponse>

Query by Reference Id

Reference Id is a value generated by your commerce to identify an order. You can use the ORDER_DETAIL_BY_REFERENCE_CODE to consult the status of an Order by your own order identifier (reference). The following are the request and response examples for this method.


Request example:

{
   "test": false,
   "language": "en",
   "command": "ORDER_DETAIL_BY_REFERENCE_CODE",
   "merchant": {
      "apiLogin": "pRRXKOl8ikMmt9u",
      "apiKey": "4Vj8eK4rloUd272L48hsrarnUA"
   },
   "details": {
      "referenceCode": "HP14015317573744"
   }
}

Response example:

{
    "code": "SUCCESS",
    "error": null,
    "result": {
        "payload": [
            {
                "id": 844427581,
                "accountId": 512321,
                "status": "CAPTURED",
                "referenceCode": "HP14015317573744",
                "description": "9518567a-0da7-44f9-b4d5-f8b8ac8d96d4",
                "airlineCode": null,
                "language": "pt",
                "notifyUrl": "http://api-pay-aff.vulcano.rocks/hotpay-notification-server/api/v1/payu/notification",
                "shippingAddress": null,
                "buyer": {
                    "merchantBuyerId": "0c970b19-3fbf-362c-b64b-c2c6ece8d01a",
                    "fullName": "APPROVED",
                    "emailAddress": "e26a8f06-64ef-49aa-8897-29df2f664017@usetheforce.com",
                    "contactPhone": null,
                    "buyerAddress": {
                        "street1": "ae QOprITzE",
                        "street2": "448",
                        "city": "BH",
                        "state": "MG",
                        "country": "CO",
                        "postalCode": "27519777",
                        "phone": null
                    },
                    "dniNumber": "1111",
                    "cnpj": "61609024311"
                },
                "antifraudMerchantId": null,
                "isTest": true,
                "transactions": [
                    {
                        "id": "76b724ee-f8e3-4228-84ca-d9e0a9d5d2b7",
                        "order": null,
                        "creditCard": {
                            "maskedNumber": "411111******1111",
                            "issuerBank": "THE CHASE MANHATTAN BANK",
                            "name": "APPROVED",
                            "cardType": null
                        },
                        "bankAccount": null,
                        "type": "AUTHORIZATION_AND_CAPTURE",
                        "parentTransactionId": null,
                        "paymentMethod": "VISA",
                        "source": null,
                        "paymentCountry": "CO",
                        "transactionResponse": {
                            "state": "APPROVED",
                            "paymentNetworkResponseCode": null,
                            "paymentNetworkResponseErrorMessage": null,
                            "trazabilityCode": "00000000",
                            "authorizationCode": "00000000",
                            "pendingReason": null,
                            "responseCode": "APPROVED",
                            "errorCode": null,
                            "responseMessage": null,
                            "transactionDate": null,
                            "transactionTime": null,
                            "operationDate": 1531757342757,
                            "extraParameters": null
                        },
                        "deviceSessionId": null,
                        "ipAddress": "10.100.1.30",
                        "cookie": null,
                        "userAgent": "Apache-HttpClient/4.3.1 (java 1.5)",
                        "expirationDate": null,
                        "payer": {
                            "merchantPayerId": "c48c9d72c2344173a8a66ad157f1415e@payutest.com",
                            "fullName": "APPROVED",
                            "billingAddress": {
                                "street1": "ae QOprITzE",
                                "street2": "448",
                                "city": "BH",
                                "state": "MG",
                                "country": "CO",
                                "postalCode": "27519777",
                                "phone": null
                            },
                            "emailAddress": "e26a8f06-64ef-49aa-8897-29df2f664017@usetheforce.com",
                            "contactPhone": null,
                            "dniNumber": "1111",
                            "dniType": null
                        },
                        "termsAndConditionId": 202,
                        "additionalValues": {
                            "PM_PAYER_COMMISSION_VALUE": {
                                "value": 0.00,
                                "currency": "COP"
                            },
                            "DP_MERCHANT_COMMISSION_VALUE": {
                                "value": 119.00,
                                "currency": "COP"
                            },
                            "COMMISSION_VALUE": {
                                "value": 0.00,
                                "currency": "COP"
                            },
                            "PM_PAYER_TOTAL_AMOUNT": {
                                "value": 54600.00,
                                "currency": "COP"
                            },
                            "PM_TAX": {
                                "value": 8717.00,
                                "currency": "COP"
                            },
                            "PM_PAYER_INTEREST_VALUE": {
                                "value": 0.00,
                                "currency": "COP"
                            },
                            "TX_ADDITIONAL_VALUE": {
                                "value": 0.00,
                                "currency": "COP"
                            },
                            "PM_NETWORK_VALUE": {
                                "value": 54600.00,
                                "currency": "COP"
                            },
                            "PM_TAX_RETURN_BASE": {
                                "value": 45882.00,
                                "currency": "COP"
                            },
                            "TX_VALUE": {
                                "value": 54600.00,
                                "currency": "COP"
                            },
                            "CURRENT_TX_VALUE": {
                                "value": 54600.00,
                                "currency": "COP"
                            },
                            "TX_TAX": {
                                "value": 8717.65,
                                "currency": "COP"
                            },
                            "DP_MERCHANT_INTEREST_VALUE": {
                                "value": 0.00,
                                "currency": "COP"
                            },
                            "DP_MERCHANT_TOTAL_INCOME_VALUE": {
                                "value": 52921.05,
                                "currency": "COP"
                            },
                            "PM_PAYER_PRICING_VALUES": {
                                "value": 0.00,
                                "currency": "COP"
                            },
                            "TX_TAX_RETURN_BASE": {
                                "value": 45882.35,
                                "currency": "COP"
                            },
                            "PM_PURCHASE_VALUE": {
                                "value": 45883.00,
                                "currency": "COP"
                            },
                            "PM_ADDITIONAL_VALUE": {
                                "value": 0.00,
                                "currency": "COP"
                            },
                            "PM_VALUE": {
                                "value": 54600.00,
                                "currency": "COP"
                            }
                        },
                        "extraParameters": {
                            "MIN_SHIPPING_PAYER": "0",
                            "PRICING_PROFILE_GROUP_ID": "MG-PRICING_2_341559",
                            "MAX_SHIPPING_MERCHANT": "0",
                            "PERCENT_SHIPPING_MERCHANT": "0",
                            "MAX_SHIPPING_PAYER": "0",
                            "MERCHANT_PROFILE_ID": "MG-PRICING_1_51803",
                            "MIN_SHIPPING_MERCHANT": "0",
                            "INSTALLMENTS_NUMBER": "1"
                        }
                    }
                ],
                "additionalValues": {
                    "PM_PAYER_COMMISSION_VALUE": {
                        "value": 0.00,
                        "currency": "COP"
                    },
                    "DP_MERCHANT_COMMISSION_VALUE": {
                        "value": 119.00,
                        "currency": "COP"
                    },
                    "COMMISSION_VALUE": {
                        "value": 0.00,
                        "currency": "COP"
                    },
                    "PM_TAX": {
                        "value": 8717.00,
                        "currency": "COP"
                    },
                    "PM_PAYER_INTEREST_VALUE": {
                        "value": 0.00,
                        "currency": "COP"
                    },
                    "TX_ADDITIONAL_VALUE": {
                        "value": 0.00,
                        "currency": "COP"
                    },
                    "PM_NETWORK_VALUE": {
                        "value": 54600.00,
                        "currency": "COP"
                    },
                    "PM_TAX_RETURN_BASE": {
                        "value": 45882.00,
                        "currency": "COP"
                    },
                    "TX_VALUE": {
                        "value": 54600.00,
                        "currency": "COP"
                    },
                    "TX_TAX": {
                        "value": 8717.65,
                        "currency": "COP"
                    },
                    "DP_MERCHANT_INTEREST_VALUE": {
                        "value": 0.00,
                        "currency": "COP"
                    },
                    "PM_PAYER_PRICING_VALUES": {
                        "value": 0.00,
                        "currency": "COP"
                    },
                    "TX_TAX_RETURN_BASE": {
                        "value": 45882.35,
                        "currency": "COP"
                    },
                    "PM_PURCHASE_VALUE": {
                        "value": 45883.00,
                        "currency": "COP"
                    },
                    "PM_ADDITIONAL_VALUE": {
                        "value": 0.00,
                        "currency": "COP"
                    },
                    "PM_VALUE": {
                        "value": 54600.00,
                        "currency": "COP"
                    }
                },
                "creationDate": 1531757337149,
                "isCreatedUsingStandardIntegrationParams": null,
                "merchantId": 508029,
                "processedTransactionId": "76b724ee-f8e3-4228-84ca-d9e0a9d5d2b7",
                "orderSignature": "bbd718c869298251a91329b673c5abfa"
            }
        ]
    }
}

Request example:

<request>
	<language>en</language>
	<command>ORDER_DETAIL_BY_REFERENCE_CODE</command>
	<merchant>
		<apiLogin>pRRXKOl8ikMmt9u</apiLogin>
		<apiKey>4Vj8eK4rloUd272L48hsrarnUA</apiKey>
	</merchant>
	<details class="java.util.HashMap">
		<entry>
			<string>referenceCode</string>
			<object class="java.lang.String">HP14015317573744</object>
		</entry>
	</details>
	<isTest>false</isTest>
</request>

Response example:

<reportingResponse>
    <code>SUCCESS</code>
    <result>
        <payload class="list">
            <order>
                <id>844427581</id>
                <accountId>512321</accountId>
                <status>CAPTURED</status>
                <referenceCode>HP14015317573744</referenceCode>
                <description>9518567a-0da7-44f9-b4d5-f8b8ac8d96d4</description>
                <language>pt</language>
                <notifyUrl>http://api-pay-aff.vulcano.rocks/hotpay-notification-server/api/v1/payu/notification</notifyUrl>
                <buyer>
                    <merchantBuyerId>0c970b19-3fbf-362c-b64b-c2c6ece8d01a</merchantBuyerId>
                    <fullName>APPROVED</fullName>
                    <emailAddress>e26a8f06-64ef-49aa-8897-29df2f664017@usetheforce.com</emailAddress>
                    <buyerAddress>
                        <street1>ae QOprITzE</street1>
                        <street2>448</street2>
                        <city>BH</city>
                        <state>MG</state>
                        <country>CO</country>
                        <postalCode>27519777</postalCode>
                    </buyerAddress>
                    <dniNumber>1111</dniNumber>
                    <CNPJ>61609024311</CNPJ>
                </buyer>
                <isTest>true</isTest>
                <transactions>
                    <transaction>
                        <id>76b724ee-f8e3-4228-84ca-d9e0a9d5d2b7</id>
                        <creditCard>
                            <maskedNumber>411111******1111</maskedNumber>
                            <issuerBank>THE CHASE MANHATTAN BANK</issuerBank>
                            <name>APPROVED</name>
                        </creditCard>
                        <type>AUTHORIZATION_AND_CAPTURE</type>
                        <paymentMethod>VISA</paymentMethod>
                        <paymentCountry>CO</paymentCountry>
                        <transactionResponse>
                            <state>APPROVED</state>
                            <trazabilityCode>00000000</trazabilityCode>
                            <authorizationCode>00000000</authorizationCode>
                            <responseCode>APPROVED</responseCode>
                            <operationDate>2018-07-16T11:09:02</operationDate>
                        </transactionResponse>
                        <ipAddress>10.100.1.30</ipAddress>
                        <userAgent>Apache-HttpClient/4.3.1 (java 1.5)</userAgent>
                        <payer>
                            <merchantPayerId>c48c9d72c2344173a8a66ad157f1415e@payutest.com</merchantPayerId>
                            <fullName>APPROVED</fullName>
                            <billingAddress>
                                <street1>ae QOprITzE</street1>
                                <street2>448</street2>
                                <city>BH</city>
                                <state>MG</state>
                                <country>CO</country>
                                <postalCode>27519777</postalCode>
                            </billingAddress>
                            <emailAddress>e26a8f06-64ef-49aa-8897-29df2f664017@usetheforce.com</emailAddress>
                            <dniNumber>1111</dniNumber>
                        </payer>
                        <termsAndConditionId>202</termsAndConditionId>
                        <additionalValues>
                            <entry>
                                <string>PM_PAYER_COMMISSION_VALUE</string>
                                <additionalValue>
                                    <value>0.00</value>
                                    <currency>COP</currency>
                                </additionalValue>
                            </entry>
                            <entry>
                                <string>DP_MERCHANT_COMMISSION_VALUE</string>
                                <additionalValue>
                                    <value>119.00</value>
                                    <currency>COP</currency>
                                </additionalValue>
                            </entry>
                            <entry>
                                <string>COMMISSION_VALUE</string>
                                <additionalValue>
                                    <value>0.00</value>
                                    <currency>COP</currency>
                                </additionalValue>
                            </entry>
                            <entry>
                                <string>PM_PAYER_TOTAL_AMOUNT</string>
                                <additionalValue>
                                    <value>54600.00</value>
                                    <currency>COP</currency>
                                </additionalValue>
                            </entry>
                            <entry>
                                <string>PM_TAX</string>
                                <additionalValue>
                                    <value>8717.00</value>
                                    <currency>COP</currency>
                                </additionalValue>
                            </entry>
                            <entry>
                                <string>PM_PAYER_INTEREST_VALUE</string>
                                <additionalValue>
                                    <value>0.00</value>
                                    <currency>COP</currency>
                                </additionalValue>
                            </entry>
                            <entry>
                                <string>TX_ADDITIONAL_VALUE</string>
                                <additionalValue>
                                    <value>0.00</value>
                                    <currency>COP</currency>
                                </additionalValue>
                            </entry>
                            <entry>
                                <string>PM_NETWORK_VALUE</string>
                                <additionalValue>
                                    <value>54600.00</value>
                                    <currency>COP</currency>
                                </additionalValue>
                            </entry>
                            <entry>
                                <string>PM_TAX_RETURN_BASE</string>
                                <additionalValue>
                                    <value>45882.00</value>
                                    <currency>COP</currency>
                                </additionalValue>
                            </entry>
                            <entry>
                                <string>TX_VALUE</string>
                                <additionalValue>
                                    <value>54600.00</value>
                                    <currency>COP</currency>
                                </additionalValue>
                            </entry>
                            <entry>
                                <string>CURRENT_TX_VALUE</string>
                                <additionalValue>
                                    <value>54600.00</value>
                                    <currency>COP</currency>
                                </additionalValue>
                            </entry>
                            <entry>
                                <string>TX_TAX</string>
                                <additionalValue>
                                    <value>8717.65</value>
                                    <currency>COP</currency>
                                </additionalValue>
                            </entry>
                            <entry>
                                <string>DP_MERCHANT_INTEREST_VALUE</string>
                                <additionalValue>
                                    <value>0.00</value>
                                    <currency>COP</currency>
                                </additionalValue>
                            </entry>
                            <entry>
                                <string>DP_MERCHANT_TOTAL_INCOME_VALUE</string>
                                <additionalValue>
                                    <value>52921.05</value>
                                    <currency>COP</currency>
                                </additionalValue>
                            </entry>
                            <entry>
                                <string>PM_PAYER_PRICING_VALUES</string>
                                <additionalValue>
                                    <value>0.00</value>
                                    <currency>COP</currency>
                                </additionalValue>
                            </entry>
                            <entry>
                                <string>TX_TAX_RETURN_BASE</string>
                                <additionalValue>
                                    <value>45882.35</value>
                                    <currency>COP</currency>
                                </additionalValue>
                            </entry>
                            <entry>
                                <string>PM_PURCHASE_VALUE</string>
                                <additionalValue>
                                    <value>45883.00</value>
                                    <currency>COP</currency>
                                </additionalValue>
                            </entry>
                            <entry>
                                <string>PM_ADDITIONAL_VALUE</string>
                                <additionalValue>
                                    <value>0.00</value>
                                    <currency>COP</currency>
                                </additionalValue>
                            </entry>
                            <entry>
                                <string>PM_VALUE</string>
                                <additionalValue>
                                    <value>54600.00</value>
                                    <currency>COP</currency>
                                </additionalValue>
                            </entry>
                        </additionalValues>
                        <extraParameters>
                            <entry>
                                <string>MIN_SHIPPING_PAYER</string>
                                <string>0</string>
                            </entry>
                            <entry>
                                <string>PRICING_PROFILE_GROUP_ID</string>
                                <string>MG-PRICING_2_341559</string>
                            </entry>
                            <entry>
                                <string>MAX_SHIPPING_MERCHANT</string>
                                <string>0</string>
                            </entry>
                            <entry>
                                <string>PERCENT_SHIPPING_MERCHANT</string>
                                <string>0</string>
                            </entry>
                            <entry>
                                <string>MAX_SHIPPING_PAYER</string>
                                <string>0</string>
                            </entry>
                            <entry>
                                <string>MERCHANT_PROFILE_ID</string>
                                <string>MG-PRICING_1_51803</string>
                            </entry>
                            <entry>
                                <string>MIN_SHIPPING_MERCHANT</string>
                                <string>0</string>
                            </entry>
                            <entry>
                                <string>INSTALLMENTS_NUMBER</string>
                                <string>1</string>
                            </entry>
                        </extraParameters>
                    </transaction>
                </transactions>
                <additionalValues>
                    <entry>
                        <string>PM_PAYER_COMMISSION_VALUE</string>
                        <additionalValue>
                            <value>0.00</value>
                            <currency>COP</currency>
                        </additionalValue>
                    </entry>
                    <entry>
                        <string>DP_MERCHANT_COMMISSION_VALUE</string>
                        <additionalValue>
                            <value>119.00</value>
                            <currency>COP</currency>
                        </additionalValue>
                    </entry>
                    <entry>
                        <string>COMMISSION_VALUE</string>
                        <additionalValue>
                            <value>0.00</value>
                            <currency>COP</currency>
                        </additionalValue>
                    </entry>
                    <entry>
                        <string>PM_TAX</string>
                        <additionalValue>
                            <value>8717.00</value>
                            <currency>COP</currency>
                        </additionalValue>
                    </entry>
                    <entry>
                        <string>PM_PAYER_INTEREST_VALUE</string>
                        <additionalValue>
                            <value>0.00</value>
                            <currency>COP</currency>
                        </additionalValue>
                    </entry>
                    <entry>
                        <string>TX_ADDITIONAL_VALUE</string>
                        <additionalValue>
                            <value>0.00</value>
                            <currency>COP</currency>
                        </additionalValue>
                    </entry>
                    <entry>
                        <string>PM_NETWORK_VALUE</string>
                        <additionalValue>
                            <value>54600.00</value>
                            <currency>COP</currency>
                        </additionalValue>
                    </entry>
                    <entry>
                        <string>PM_TAX_RETURN_BASE</string>
                        <additionalValue>
                            <value>45882.00</value>
                            <currency>COP</currency>
                        </additionalValue>
                    </entry>
                    <entry>
                        <string>TX_VALUE</string>
                        <additionalValue>
                            <value>54600.00</value>
                            <currency>COP</currency>
                        </additionalValue>
                    </entry>
                    <entry>
                        <string>TX_TAX</string>
                        <additionalValue>
                            <value>8717.65</value>
                            <currency>COP</currency>
                        </additionalValue>
                    </entry>
                    <entry>
                        <string>DP_MERCHANT_INTEREST_VALUE</string>
                        <additionalValue>
                            <value>0.00</value>
                            <currency>COP</currency>
                        </additionalValue>
                    </entry>
                    <entry>
                        <string>PM_PAYER_PRICING_VALUES</string>
                        <additionalValue>
                            <value>0.00</value>
                            <currency>COP</currency>
                        </additionalValue>
                    </entry>
                    <entry>
                        <string>TX_TAX_RETURN_BASE</string>
                        <additionalValue>
                            <value>45882.35</value>
                            <currency>COP</currency>
                        </additionalValue>
                    </entry>
                    <entry>
                        <string>PM_PURCHASE_VALUE</string>
                        <additionalValue>
                            <value>45883.00</value>
                            <currency>COP</currency>
                        </additionalValue>
                    </entry>
                    <entry>
                        <string>PM_ADDITIONAL_VALUE</string>
                        <additionalValue>
                            <value>0.00</value>
                            <currency>COP</currency>
                        </additionalValue>
                    </entry>
                    <entry>
                        <string>PM_VALUE</string>
                        <additionalValue>
                            <value>54600.00</value>
                            <currency>COP</currency>
                        </additionalValue>
                    </entry>
                </additionalValues>
                <creationDate>2018-07-16T11:08:57</creationDate>
                <merchantId>508029</merchantId>
                <processedTransactionId>76b724ee-f8e3-4228-84ca-d9e0a9d5d2b7</processedTransactionId>
                <orderSignature>bbd718c869298251a91329b673c5abfa</orderSignature>
            </order>
        </payload>
    </result>
</reportingResponse>

Ping

The PING method lets you verify the connection to our platform. The following are the request and response examples for this method.


Request example:

{
   "test": false,
   "language": "en",
   "command": "PING",
   "merchant": {
      "apiLogin": "pRRXKOl8ikMmt9u",
      "apiKey": "4Vj8eK4rloUd272L48hsrarnUA"
   }
}

Response example:

{
    "code": "SUCCESS",
    "error": null,
    "result": {
        "payload": "ping"
    }
}

Request example:

<request>
   <language>en</language>
   <command>PING</command>
   <merchant>
      <apiLogin>pRRXKOl8ikMmt9u</apiLogin>
      <apiKey>4Vj8eK4rloUd272L48hsrarnUA</apiKey>
   </merchant>
   <isTest>false</isTest>
</request>

Response example:

<reportingResponse>
    <code>SUCCESS</code>
    <result>
        <payload class="string">ping</payload>
    </result>
</reportingResponse>

Last modified June 24, 2022: clon issue (d73e43fe5)