.png%3Falt%3Dmedia%26token%3Dd49067ab-2333-46c4-84d3-6605188d9de4)
.png%3Falt%3Dmedia%26token%3Dd49067ab-2333-46c4-84d3-6605188d9de4)
Notifications
This page covers the notifications and status checks available for you in order to confirm the transaction processed using our system.
Provided you include the notification_url parameter in your request the system will send a notification to your chosen endpoint in the following format:
YOUR ENDPOINT?reply_code=604&reply_desc=Order%20is%20unique%20and%20must%20be%20used%20only%20once.&trans_id=22924&trans_date=11%2F02%2F2020%2012%3A40%3A11&trans_amount=7.23
&trans_currency=USD&trans_order=ABC12365&merchant_id=3783018&[email protected]
&signature=r5b25pouS4NvsjZ3ufmI2J1fJ%2FJ2rHnRnMkeybeHzHY%3D
Field | Description |
|---|---|
reply_code | |
reply_desc | The reason for the decline as it is provided from the provider or by the system - for further info contact Support |
trans_id | The transaction ID that is generate by our system |
trans_date | The time and date of the transaction - Time is set to GMT (URL Encoded) |
trans_amount | The amount of the transaction that was processed |
trans_currency | The currency in which the transaction was processed. (ISO Code - USD/EUR/GBP) |
trans_order | The order id that was sent by the merchant to our system - the unique identifier on the merchant CRM system. |
payment_details | This will return the payment method used |
merchant_id | The company id as it was provided to the merchant by Support (Company Number) |
client_fullname | The full name of the client that was included in the transaction. |
client_phone | The phone number of the client that was included in the transaction. |
client_email | The email address of the client that was included in the transaction. |
signature | base64( hash('sha256', trans_id + trans_order + reply_code + trans_amount + trans_currency + merchanthash)) |
* Reply codes are either from system or from the providers we work with - list of declines may change from time to time.
** Approved reply code would always be 000 and Pending would be 553.
*** Please be sure to support POST on your end to receive the notification
Service to request a transaction status - by default the service will return the PENDING transaction id that was sent given that this service was built for the purpose of checking 3DS transactions, you can adjust the RequestType field to "1" to receive all other types of transaction status.
https://process.oobit.com/member/getStatus.asp
Field | Required | Description |
|---|---|---|
CompanyNum | Yes | Your merchant number - 5722306 |
TransID | Yes | ID number of transaction |
RequestType | No | For a non-pending transaction send "1" |
https://process.oobit.com/member/getStatus.asp?CompanyNum=XXXXXXX&TransID=XXXX
Field | Description |
|---|---|
Reply | Reply code (see list of possible reply codes of Silent Post) |
ReplyDesc | Reply description |
TransID | ID number of transaction |
Reply=XXX&ReplyDesc=Some Reply Description&TransID=XXXX
Service to request the response for a specific order id as configured on the merchant CRM system - Since there are cases where the Merchant might be using the same Order ID for multiple transactions, some approved some declined the service will return a JSON response holding all the relevant transactions found with that Order ID for that Merchant.
https://process.oobit.com/member/getStatus.asp
Field | Required | Description |
|---|---|---|
CompanyNum | Yes | Your merchant number - 5722306 |
Order | Yes | ID number of transaction |
Signature | Yes | Signature creation algorithm is: base64(Hash("SHA256",CompanyNum + Order + MerchantHashKey))
signature output example: ZaezsN+9xHWkLorQgtNW5M+fB6/lVP4SgtlUDwgBl+0= |
https://process.oobit.com/member/getStatus.asp?Order=XXXXXXX&CompanyNum=XXXXXXX&signature=ZaezsN+9xHWkLorQgtNW5M+fB6/lVP4SgtlUDwgBl+0=
Field | Description |
|---|---|
Reply | Reply code (see list of possible reply codes of Silent Post) |
ReplyDesc | Reply description |
TransID | ID number of transaction |
trans_date | Date and time of the transaction |
merchantID | Company Number |
trans_amount | Transaction amount |
trans_currency | Transaction currency |
trans_installments | The number of installments for the transaction. |
client_email | Email |
Response example in JSON format:
{
"error": "0",
"message": "SUCCESS",
"data": [
{
"replyCode": "000",
"replyDesc": "SUCCESS",
"trans_id": "4091",
"trans_date": "24/12/2017 21:03:04",
"merchantID": "XXXXXXX",
"trans_amount": "1",
"trans_currency": "EUR",
"trans_installments": "1",
"client_email": "[email protected]"
}
]
}
Or failed response example:
{
"error": "103",
"message": "Failed On Authentication",
"data": []
}
Last modified 10mo ago