PayU

Last changes: 04-16-2020

You can capture the authorized amount in a single API request using 1.29 Capture

Capture request

Path:

POST {Base URL}/payment/BNkk4BRkQEufPSvgf9lDwA/capture

Header:

Content-Type: application/json
Accept-Language: en-US
X-Auth-Token: X-Auth-Token: H4sIAAAAAAA{partial omission for brevity}EAN2bJ/6l2XX+A5kJqdP+MwAA

{
"partnerReference": "DEV-SVR001-DE_CUSTID-KD97TH2FP6_CARTID-PYQRTGMCMQ_Y98CGTK2CJ",
"modifiedAmount": 3.99,
"modifiedAmountCurrCode": "PLN",
"localDate": "2020-02-17",
"localTime": "173912"
}

Capture Response

Status Code:

200 (OK)

Header:

Content-Type: application/json
Accept-Language: en-US

{
    "initiatorAccno": "5183630515",
    "accno": "5183646503",
    "uniqueReference": "4hjhwV8K5Uq4204Gq8uJXA",
    "modifiedAmount": 3.99,
    "modifiedAmountCurrCode": "PLN",
    "processedAmount": 3.99,
    "processedCurrCode": "PLN",
    "statusCode": "CAPTURED",
    "statusReason": "Captured",
    "paymentProviderResponse": [
        {
            "id": "f02fe6b6-a942-4a27-a171-c9e636790442",
            "currency": "PLN",
            "created": "1581953877287",
            "modified": "1581953905266",
            "status": "Authorized",
            "payment_method": {
                "billing_address": {},
                "type": "untokenized",
                "source_type": "PBL"
            },
            "provider_configuration": {
                "id": "d56aae02-efa8-4e5f-9ee1-7b166d23asdasd",
                "name": "Description",
                "description": "Description",
                "created": "1503568002239",
                "modified": "1503672766715",
                "account_id": "2ffc1077-2562-489b-a93b-0b527302cd69",
                "provider_id": "2bb71903-fe65-45fe-8002-1967a43dd64e",
                "type": "cc_processor",
                "href": "https://api.paymentsos.com/accounts/2ffc1077-2562-489b-a93b-0b527302cd69/provider-configurations/d56aae02-efa8-4e5f-9ee1-7b166d2320b0"
            },
            "related_resources": {
                "authorizations": [
                    {
                        "id": "de65cd27-d99f-4d34-a4b7-32cb3fb6d626",
                        "created": "1581953877775",
                        "reconciliation_id": "4hjhwV8K5Uq4204Gq8uJXA",
                        "provider_specific_data": {
                            "additional_details": {
                                "bank_name": "payment_wall",
                                "language": "en"
                            }
                        },
                        "payment_method": {
                            "billing_address": {},
                            "type": "untokenized",
                            "source_type": "PBL"
                        },
                        "ip_address": "217.111.119.130",
                        "originating_purchase_country": "DEU",
                        "result": {
                            "status": "Succeed"
                        },
                        "provider_data": {
                            "provider_name": "PayUPoland",
                            "response_code": "WAITING_FOR_CONFIRMATION",
                            "raw_response": "{\"order.products.0.quantity\":\"1\",\"order.status\":\"WAITING_FOR_CONFIRMATION\",\"order.products.0.unitPrice\":\"10000\",\"order.additionalDescription\":\"PayU HUB Transaction\",\"properties.0.value\":\"76277177\",\"order.totalAmount\":\"10000\",\"order.merchantPosId\":\"301945\",\"order.description\":\"4hjhwV8K5Uq4204Gq8uJXA\",\"order.products.0.name\":\"wweettPurchase:2xPremiumWidgets. Merchant:WidgetsGmbH. CUSTREF:52650FD95. Hotline:08001234567.\",\"order.extOrderId\":\"Test Program - 4hjhwV8K5Uq4204Gq8uJXA_1581953877575\",\"properties.0.name\":\"PAYMENT_ID\",\"order.notifyUrl\":\"https://api.paymentsos.com/callbacks/payupoland/test/notifications?payment_id=f02fe6b6-a942-4a27-a171-c9e636790442&x-zooz-request-id=8920b229-4dcd-4d4d-aea1-ce58121e5d1d\",\"order.customerIp\":\"217.111.119.130\",\"order.orderCreateDate\":\"2020-02-17T16:37:57.695+01:00\",\"order.currencyCode\":\"PLN\",\"order.orderId\":\"J5P3KQ62Q6200217GUEST000P01\"}",
                            "transaction_id": "76277177",
                            "external_id": "J5P3KQ62Q6200217GUEST000P01"
                        },
                        "amount": 10000,
                        "provider_configuration": {
                            "id": "d56aae02-efa8-4e5f-9ee1-7b166d2320b0",
                            "name": "PayU_PL_Snb_MSh1",
                            "description": "Description",
                            "created": "1503568002239",
                            "modified": "1503672766715",
                            "account_id": "2ffc1077-2562-489b-a93b-0b527302cd69",
                            "provider_id": "2bb71903-fe65-45fe-8002-1967a43dd64e",
                            "type": "cc_processor",
                            "href": "https://api.paymentsos.com/accounts/2ffc1077-2562-489b-a93b-0b527302cd69/provider-configurations/d56aae02-efa8-4e5f-9ee1-7b166d2320b0"
                        },
                        "href": "https://api.paymentsos.com/payments/f02fe6b6-a942-4a27-a171-c9e636790442/authorizations/de65cd27-d99f-4d34-a4b7-32cb3fb6d626"
                    }
                ],
                "redirections": [
                    {
                        "id": "602127e0-6c17-4a31-b6e4-99608113ea11",
                        "created": "1581953877755",
                        "merchant_site_url": "https://example.com/PaymentOption/CompleteAuthorize?id=4hjhwV8K5Uq4204Gq8uJXA",
                        "url": "https://merch-prod.snd.payu.com/pay/?orderId=J5P3KQ62Q6200217GUEST000P01&token=eyJhbGciOiJIUzI1NiJ9.eyJvcmRlcklkIjoiSjVQM0tRNjJRNjIwMDIxN0dVRVNUMDAwUDAxIiwicG9zSWQiOiJza3lURWxrYSIsImF1dGhvcml0aWVzIjpbIlJPTEVfQ0xJRU5UIl0sImV4cCI6MTU4MjA0MDI3NywiaXNzIjoiUEFZVSIsImF1ZCI6ImFwaS1nYXRld2F5Iiwic3ViIjoiUGF5VSBzdWJqZWN0IiwianRpIjoiYmVjZjc1NGMtYTYwYy00ZTMyLTg5NmEtOGI5ODJhMzQzMjQ4In0.1g5WQzxwU2tpD3U-pFBZTtmA1dySRrEggyC5FQnzABM",
                        "href": "https://api.paymentsos.com/payments/f02fe6b6-a942-4a27-a171-c9e636790442/redirections/602127e0-6c17-4a31-b6e4-99608113ea11"
                    }
                ]
            },
            "billing_address": {},
            "possible_next_actions": [
                {
                    "action": "Void",
                    "href": "https://api.paymentsos.com/payments/f02fe6b6-a942-4a27-a171-c9e636790442/voids"
                },
                {
                    "action": "Capture",
                    "href": "https://api.paymentsos.com/payments/f02fe6b6-a942-4a27-a171-c9e636790442/captures"
                }
            ],
            "order": {
                "id": "Test Program - 4hjhwV8K5Uq4204Gq8uJXA",
                "line_items": [
                    {
                        "name": "wweettPurchase:2xPremiumWidgets. Merchant:WidgetsGmbH. CUSTREF:52650FD95. Hotline:08001234567.",
                        "id": "Test Program",
                        "quantity": 1,
                        "unit_price": 10000
                    }
                ]
            },
            "amount": 10000
        },
        {
            "id": "d16d7f39-5f40-4bdf-b1ff-01a721748478",
            "created": "1581953954882",
            "reconciliation_id": "4hjhwV8K5Uq4204Gq8uJXA",
            "result": {
                "status": "Pending"
            },
            "amount": 10000,
            "provider_data": {
                "provider_name": "PayUPoland",
                "response_code": "SUCCESS",
                "raw_response": "{\"status.statusDesc\":\"Status was updated\",\"status.statusCode\":\"SUCCESS\"}"
            },
            "provider_configuration": {
                "id": "d56aae02-efa8-4e5f-9ee1-7b166d2320b0",
                "name": "PayU_PL_Snb_MSh1",
                "description": "PayU Merchant 1 - Sandbox PL - PLN",
                "created": "1503568002239",
                "modified": "1503672766715",
                "account_id": "2ffc1077-2562-489b-a93b-0b527302cd69",
                "provider_id": "2bb71903-fe65-45fe-8002-1967a43dd64e",
                "type": "cc_processor",
                "href": "https://api.paymentsos.com/accounts/2ffc1077-2562-489b-a93b-0b527302cd69/provider-configurations/d56aae02-efa8-4e5f-9ee1-7b166d2320b0"
            }
        },
        {
            "id": "f02fe6b6-a942-4a27-a171-c9e636790442",
            "currency": "PLN",
            "created": "1581953877287",
            "modified": "1581953956902",
            "status": "Captured",
            "payment_method": {
                "billing_address": {},
                "type": "untokenized",
                "source_type": "PBL"
            },
            "provider_configuration": {
                "id": "d56aae02-efa8-4e5f-9ee1-7b166d2320b0",
                "name": "PayU_PL_Snb_MSh1",
                "description": "PayU Merchant 1 - Sandbox PL - PLN",
                "created": "1503568002239",
                "modified": "1503672766715",
                "account_id": "2ffc1077-2562-489b-a93b-0b527302cd69",
                "provider_id": "2bb71903-fe65-45fe-8002-1967a43dd64e",
                "type": "cc_processor",
                "href": "https://api.paymentsos.com/accounts/2ffc1077-2562-489b-a93b-0b527302cd69/provider-configurations/d56aae02-efa8-4e5f-9ee1-7b166d2320b0"
            },
            "related_resources": {
                "authorizations": [
                    {
                        "id": "de65cd27-d99f-4d34-a4b7-32cb3fb6d626",
                        "created": "1581953877775",
                        "reconciliation_id": "4hjhwV8K5Uq4204Gq8uJXA",
                        "provider_specific_data": {
                            "additional_details": {
                                "bank_name": "payment_wall",
                                "language": "en"
                            }
                        },
                        "payment_method": {
                            "billing_address": {},
                            "type": "untokenized",
                            "source_type": "PBL"
                        },
                        "ip_address": "217.111.119.130",
                        "originating_purchase_country": "DEU",
                        "result": {
                            "status": "Succeed"
                        },
                        "provider_data": {
                            "provider_name": "PayUPoland",
                            "response_code": "WAITING_FOR_CONFIRMATION",
                            "raw_response": "{\"order.products.0.quantity\":\"1\",\"order.status\":\"WAITING_FOR_CONFIRMATION\",\"order.products.0.unitPrice\":\"10000\",\"order.additionalDescription\":\"PayU HUB Transaction\",\"properties.0.value\":\"76277177\",\"order.totalAmount\":\"10000\",\"order.merchantPosId\":\"301945\",\"order.description\":\"4hjhwV8K5Uq4204Gq8uJXA\",\"order.products.0.name\":\"wweettPurchase:2xPremiumWidgets. Merchant:WidgetsGmbH. CUSTREF:52650FD95. Hotline:08001234567.\",\"order.extOrderId\":\"Test Program - 4hjhwV8K5Uq4204Gq8uJXA_1581953877575\",\"properties.0.name\":\"PAYMENT_ID\",\"order.notifyUrl\":\"https://api.paymentsos.com/callbacks/payupoland/test/notifications?payment_id=f02fe6b6-a942-4a27-a171-c9e636790442&x-zooz-request-id=8920b229-4dcd-4d4d-aea1-ce58121e5d1d\",\"order.customerIp\":\"217.111.119.130\",\"order.orderCreateDate\":\"2020-02-17T16:37:57.695+01:00\",\"order.currencyCode\":\"PLN\",\"order.orderId\":\"J5P3KQ62Q6200217GUEST000P01\"}",
                            "transaction_id": "76277177",
                            "external_id": "J5P3KQ62Q6200217GUEST000P01"
                        },
                        "amount": 10000,
                        "provider_configuration": {
                            "id": "d56aae02-efa8-4e5f-9ee1-7b166d2320b0",
                            "name": "PayU_PL_Snb_MSh1",
                            "description": "PayU Merchant 1 - Sandbox PL - PLN",
                            "created": "1503568002239",
                            "modified": "1503672766715",
                            "account_id": "2ffc1077-2562-489b-a93b-0b527302cd69",
                            "provider_id": "2bb71903-fe65-45fe-8002-1967a43dd64e",
                            "type": "cc_processor",
                            "href": "https://api.paymentsos.com/accounts/2ffc1077-2562-489b-a93b-0b527302cd69/provider-configurations/d56aae02-efa8-4e5f-9ee1-7b166d2320b0"
                        },
                        "href": "https://api.paymentsos.com/payments/f02fe6b6-a942-4a27-a171-c9e636790442/authorizations/de65cd27-d99f-4d34-a4b7-32cb3fb6d626"
                    }
                ],
                "redirections": [
                    {
                        "id": "602127e0-6c17-4a31-b6e4-99608113ea11",
                        "created": "1581953877755",
                        "merchant_site_url": "https://example.com/PaymentOption/CompleteAuthorize?id=4hjhwV8K5Uq4204Gq8uJXA",
                        "url": "https://merch-prod.snd.payu.com/pay/?orderId=J5P3KQ62Q6200217GUEST000P01&token=eyJhbGciOiJIUzI1NiJ9.eyJvcmRlcklkIjoiSjVQM0tRNjJRNjIwMDIxN0dVRVNUMDAwUDAxIiwicG9zSWQiOiJza3lURWxrYSIsImF1dGhvcml0aWVzIjpbIlJPTEVfQ0xJRU5UIl0sImV4cCI6MTU4MjA0MDI3NywiaXNzIjoiUEFZVSIsImF1ZCI6ImFwaS1nYXRld2F5Iiwic3ViIjoiUGF5VSBzdWJqZWN0IiwianRpIjoiYmVjZjc1NGMtYTYwYy00ZTMyLTg5NmEtOGI5ODJhMzQzMjQ4In0.1g5WQzxwU2tpD3U-pFBZTtmA1dySRrEggyC5FQnzABM",
                        "href": "https://api.paymentsos.com/payments/f02fe6b6-a942-4a27-a171-c9e636790442/redirections/602127e0-6c17-4a31-b6e4-99608113ea11"
                    }
                ],
                "captures": [
                    {
                        "id": "d16d7f39-5f40-4bdf-b1ff-01a721748478",
                        "created": "1581953954882",
                        "reconciliation_id": "4hjhwV8K5Uq4204Gq8uJXA",
                        "result": {
                            "status": "Succeed"
                        },
                        "amount": 10000,
                        "provider_data": {
                            "provider_name": "PayUPoland",
                            "response_code": "COMPLETED",
                            "raw_response": "{\"order.products.0.quantity\":\"1\",\"localReceiptDateTime\":\"2020-02-17T16:39:14.894+01:00\",\"order.status\":\"COMPLETED\",\"order.products.0.unitPrice\":\"10000\",\"order.buyer.customerId\":\"guest\",\"order.buyer.language\":\"en\",\"order.additionalDescription\":\"PayU HUB Transaction\",\"properties.0.value\":\"76277177\",\"order.totalAmount\":\"10000\",\"order.merchantPosId\":\"301945\",\"order.description\":\"4hjhwV8K5Uq4204Gq8uJXA\",\"order.products.0.name\":\"wweettPurchase:2xPremiumWidgets. Merchant:WidgetsGmbH. CUSTREF:52650FD95. Hotline:08001234567.\",\"order.extOrderId\":\"Test Program - 4hjhwV8K5Uq4204Gq8uJXA_1581953877575\",\"properties.0.name\":\"PAYMENT_ID\",\"order.notifyUrl\":\"https://api.paymentsos.com/callbacks/payupoland/test/notifications?payment_id=f02fe6b6-a942-4a27-a171-c9e636790442&x-zooz-request-id=8920b229-4dcd-4d4d-aea1-ce58121e5d1d\",\"order.customerIp\":\"217.111.119.130\",\"order.payMethod.type\":\"PBL\",\"order.orderCreateDate\":\"2020-02-17T16:37:57.695+01:00\",\"order.payMethod.amount\":\"10000\",\"order.currencyCode\":\"PLN\",\"order.orderId\":\"J5P3KQ62Q6200217GUEST000P01\",\"order.buyer.email\":\"ivan@yasd.com\"}",
                            "transaction_id": "76277177"
                        },
                        "provider_configuration": {
                            "id": "d56aae02-efa8-4e5f-9ee1-7b166d2320b0",
                            "name": "PayU_PL_Snb_MSh1",
                            "description": "PayU Merchant 1 - Sandbox PL - PLN",
                            "created": "1503568002239",
                            "modified": "1503672766715",
                            "account_id": "2ffc1077-2562-489b-a93b-0b527302cd69",
                            "provider_id": "2bb71903-fe65-45fe-8002-1967a43dd64e",
                            "type": "cc_processor",
                            "href": "https://api.paymentsos.com/accounts/2ffc1077-2562-489b-a93b-0b527302cd69/provider-configurations/d56aae02-efa8-4e5f-9ee1-7b166d2320b0"
                        },
                        "href": "https://api.paymentsos.com/payments/f02fe6b6-a942-4a27-a171-c9e636790442/captures/d16d7f39-5f40-4bdf-b1ff-01a721748478"
                    }
                ]
            },
            "billing_address": {},
            "possible_next_actions": [
                {
                    "action": "Void",
                    "href": "https://api.paymentsos.com/payments/f02fe6b6-a942-4a27-a171-c9e636790442/voids"
                },
                {
                    "action": "Capture",
                    "href": "https://api.paymentsos.com/payments/f02fe6b6-a942-4a27-a171-c9e636790442/captures"
                },
                {
                    "action": "Refund",
                    "href": "https://api.paymentsos.com/payments/f02fe6b6-a942-4a27-a171-c9e636790442/refunds"
                }
            ],
            "order": {
                "id": "Test Program - 4hjhwV8K5Uq4204Gq8uJXA",
                "line_items": [
                    {
                        "name": "wweettPurchase:2xPremiumWidgets. Merchant:WidgetsGmbH. CUSTREF:52650FD95. Hotline:08001234567.",
                        "id": "Test Program",
                        "quantity": 1,
                        "unit_price": 10000
                    }
                ]
            },
            "amount": 10000
        }
    ],
    "partnerReference": "DEV-SVR001-DE_CUSTID-KD97TH2FP6_CARTID-PYQRTGMCMQ_Y98CGTK2CJ",
    "localDate": "2020-02-17",
    "localTime": "173912",
    "sysDate": "2020-02-17",
    "sysTime": "153920",
    "responseCode": "0000",
    "responseDescription": "Successful execution."
}

PayU Callback

If 1.29 Capture response returns responseCode == 0006 and additionalInformation.processingStatus == Pending the integrating party can call 1.41 Get Payment Status or wait for a callback if configured.

If 1.29 Capture response returns responseCode == 0015 and additionalInformation.statusCode == CAPTURED this means the amount has been successfully captured.

The Callback will return the following JSON structure to the integrating party:

Callback Response

{
    "notificationType": "CaptureFeedback",
    "processingStatus": "Status of transaction processing: 'Success' or 'Failed'",
    "processingReason": "Description of the transaction processing status",
    "transactionStatus": "AUTHORIZED or CAPTURED",
    "uniqueReference": "Unique reference of the transaction",
    "relatedTransactionReferences": [{
        Array of transaction references of dependent transactions which are updated,
        if available.Otherwise, the array is empty.
    }]
}