If the transactionStatus in the callback response is AUTHORIZED it means the payment amount has not been captured.
If the transactionStatus is CAPTURED the payment has been successfully captured.
PayU Pay-by-Link
Last changes: 04-12-2023
You can capture the authorized amount in a single API request using 1.29 Capture
Capture request
-
Path:
-
POST {baseURL}/payment/BNkk4BRkQEufPSvgf9lDwA/capture
-
Header:
-
Content-Type: application/json
Accept-Language: en-US
X-Auth-Token: eyJhbGciOiJSUzI1NiI{abbreviated}RW5kVG9rZW4=
{
"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\":\"user@example.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.",
"additionalInformation": {
"requestId": "aff2728481a181dc36daedc14055b516"
}
}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.
}]
}