Callback to redirect URL reference
When a payment request is sent to Revup, after the initial API response is returned, a list of transactions with further information is sent to one of the redirectUrls indicated in the original order or in the merchant configuration. This list will be sorted by creation date, and may contain just one transaction, or two in case a fallback MID is configured (the first element of the list will represent the first failed attempt). The information is sent to the success URL when the payment is completed or being processed, or to the fail URL otherwise.
Even in synchronous payments, the redirectUrl message might specify that the current transaction status is in_process, indicating that the acquirer did not provide an answer during the established time. In such cases, the final status will be sent via notification or could also be checked querying the transaction information at any time.
Message to redirect URL example
Succesful transaction without fallback
[
{
"orderId": "e1aa046e-83ee-4591-8ecf-1a8469fffbbb",
"transactionId": "c2c53654-c51e-4463-954f-3d6674085479",
"transactionStatus": "success",
"createdAt": "2023-01-12T12:41:29.214Z",
"tokenId": "7686b2aa-1e28-4b0e-a4b3-03f64b3956fe",
"mid": {
"id": "214f0c35-dc8a-42dd-828d-9576d967e007",
"providerApi": "trustpay",
"paymentSolution": "SolutionTP"
},
"liabilityShift": false,
"cardInfo": {
"cardHolder": "Ak da Bilbao",
"cardNumber": "*****cardNumber",
"expireDate": {
"year": "2034",
"month": "05"
},
"binInfo": {
"cardBrand": "visa",
"country": "US",
"bankInfo": {
"bank": "JPMORGAN CHASE BANK, N.A.",
"website": "www.jpmorganchase.com",
"phone": "416-981-9200"
}
}
},
"orderInfo": {
"money": {
"amount": 9.98,
"currency": "EUR"
},
"description": "entertainment subscription",
"concept": "test",
"userInformation": {
"ip": "251.251.213.216",
"email": "TEST+12@trustpay.es",
"country": "ES",
"language": "ES",
"browserInformation": {
"userAgentHeader": "Mozilla/5.0",
"acceptHeader": "text/html"
}
},
"generateToken": true,
"domain": "HTTPS://WWW.QA_TRUSTPAY.COM",
"paymentDetails": {
"type": "credit_card_present"
},
"customTag": "QA_TRUSTPAY",
"notificationUrl": "https://www.merchant-domain.es/notification",
"redirectUrl": {
"success": "https://ded0-54-73-197-22.eu.ngrok.io/success",
"fail": "https://ded0-54-73-197-22.eu.ngrok.io/failed",
"threeDSChallengeResult": "https://ded0-54-73-197-22.eu.ngrok.io/challenge"
}
},
"operationResult": {
"chargedAmount": {
"amount": 9.98,
"currency": "EUR"
}
},
"paymentMethod": "credit_card_ciphered_data",
"isFallback": false,
"version": 2
}
]
Succesful transaction with fallback
[
{
"orderId": "74057e6e-3832-417a-ad90-b7b018640902",
"error": {
"code": "0702",
"message": "3D Secure Configuration Error"
},
"transactionId": "713f22f1-6814-463f-8b43-2d6e07bcd8a1",
"transactionStatus": "failed",
"createdAt": "2023-01-12T12:47:22.749Z",
"mid": {
"id": "5e1448ca-6b73-4a46-9c14-ab83db044ac2",
"providerApi": "trustpay",
"paymentSolution": "solutionTP-Fallback"
},
"liabilityShift": false,
"cardInfo": {
"cardHolder": "Ak da Bilbao",
"cardNumber": "*****cardNumber",
"expireDate": {
"year": "2034",
"month": "05"
},
"binInfo": {
"cardBrand": "visa",
"cardType": "credit",
"country": "US",
"bankInfo": {
"bank": "EXTRAS TEST - VISA",
"phone": "613-228-4040"
}
}
},
"orderInfo": {
"money": {
"amount": 9.98,
"currency": "USD"
},
"description": "Simple payment with trustpay",
"concept": "test",
"userInformation": {
"ip": "251.251.213.216",
"email": "test@trustpay.es",
"country": "ES",
"language": "ES"
},
"generateToken": true,
"domain": "HTTPS://WWW.QA_TRUSTPAY_FB1.COM",
"paymentDetails": {
"type": "credit_card_present"
},
"customTag": "QA_TRUSTPAY_FB1",
"threeDSSupport": "preferred_3ds",
"notificationUrl": "https://ded0-54-73-197-22.eu.ngrok.io/notification",
"redirectUrl": {
"success": "https://ded0-54-73-197-22.eu.ngrok.io/success",
"fail": "https://ded0-54-73-197-22.eu.ngrok.io/failed",
"threeDSChallengeResult": "https://ded0-54-73-197-22.eu.ngrok.io/challenge"
}
},
"paymentMethod": "credit_card_ciphered_data",
"isFallback": false,
"version": 2
},
{
"orderId": "74057e6e-3832-417a-ad90-b7b018640902",
"transactionId": "4ea944a7-5666-41ea-bb15-c488d87d5e82",
"transactionStatus": "waiting_user_interaction",
"createdAt": "2023-01-12T12:47:26.988Z",
"tokenId": "545eb0d4-ecff-49b7-957d-c521df2bbb3e",
"mid": {
"id": "bf294845-77ca-4ccc-9fb0-29bd3332d03e",
"providerApi": "paynopain",
"paymentSolution": "paynopain"
},
"liabilityShift": false,
"cardInfo": {
"cardHolder": "Ak da Bilbao",
"cardNumber": "*****cardNumber",
"expireDate": {
"year": "2034",
"month": "05"
},
"binInfo": {
"cardBrand": "visa",
"cardType": "credit",
"country": "US",
"bankInfo": {
"bank": "EXTRAS TEST - VISA",
"phone": "613-228-4040"
}
}
},
"orderInfo": {
"money": {
"amount": 9.98,
"currency": "USD"
},
"description": "Simple payment with trustpay",
"concept": "test",
"userInformation": {
"ip": "251.251.213.216",
"email": "test@trustpay.es",
"country": "ES",
"language": "ES"
},
"generateToken": true,
"domain": "HTTPS://WWW.QA_TRUSTPAY_FB1.COM",
"paymentDetails": {
"type": "credit_card_present"
},
"customTag": "QA_TRUSTPAY_FB1",
"threeDSSupport": "preferred_3ds"
"notificationUrl": "https://ded0-54-73-197-22.eu.ngrok.io/notification",
"redirectUrl": {
"success": "https://ded0-54-73-197-22.eu.ngrok.io/success?text=123456",
"fail": "https://ded0-54-73-197-22.eu.ngrok.io/failed",
"threeDSChallengeResult": "https://ded0-54-73-197-22.eu.ngrok.io/challenge"
}
},
"operationResult": {
"chargedAmount": {
"amount": 9.98,
"currency": "USD"
}
},
"paymentMethod": "credit_card_ciphered_data",
"isFallback": true,
"action": {
"url": "https://api.paylands.com/v1/sandbox/payment/tokenized/896dcbe60115ab0ab4d35c41cb8b3d587035da921fb5967b0048e2f8687034306f5debe787e4bbb86bee7b230c3ce5696b1c1566674f72078089442350ebf085",
"method": "GET"
},
"version": 2
}
]
Failed transaction
[
{
"orderId": "37a93c45-bc1c-465f-8454-e94c69a8566d",
"error": {
"code": "0900",
"message": "Internal Server Error"
},
"transactionId": "067f48b8-14e9-40aa-88c0-6a72112417ff",
"transactionStatus": "failed",
"mid": {
"id": "56ac097c-3a04-44bb-a05c-0dbd5e065009",
"providerApi": "<acquirer.name>",
"paymentSolution": "<acquirer.solution>"
},
"liabilityShift": false,
"cardInfo": {
"cardBrand": "visa",
"cardHolder": "Marc Casas",
"cardNumber": "400005******5556",
"expireDate": {
"year": 2023,
"month": 10
}
},
"orderInfo": {
"money": {
"amount": 0.95,
"currency": "USD"
},
"description": "New order from merchant",
"concept": "Order concept",
"userInformation": {
"ip": "84.102.122.9",
"email": "user@test.com",
"country": "ES",
"language": "ES",
"customerId": "12345678901234567890",
"browserInformation": {
"userAgentHeader": "Mozilla/5.0",
"acceptHeader": "text/html"
}
},
"generateToken": false,
"domain": "https://www.merchant-domain.es",
"parentTransactionId": "e2d613d3-2ae0-46f9-89a4-3374884cb897",
"paymentDetails": {
"type": "recurrence",
"minPeriod": 30,
"sequence": "initial"
}
},
"operationResult": {
"chargedAmount": {
"amount": 0.95,
"currency": "USD"
}
},
"version": 2
}
]