Diagnose Interface 2 tables
1. REQUEST PARAMETERS WITH TRANSACTION-ID
The POST request should contain the following mandatory components:
- Test Credentials
EXAMPLE :
Diagnose Request & Response with transaction-id
Diagnose Request
| Field Name | Type | Length | Mandatory? | Description | |
|---|---|---|---|---|---|
| merchantid | alphanumeric | 40 characters | ✔ | merchant identification | |
| type | alphanumeric | ✔ | tx | ||
| transactionid | numeric | empty or transactionid | payment gateway transaction identification | ✔ | numeric |
| signature | hex | 40 characters | SHA1–Hash | ✔ | Signature Calculation |
Diagnose Response
| Field Name | Type | Content | Description |
|---|---|---|---|
| amount | numeric | empty or amount value | amount |
| creation_date | alphanumeric | creation date | Date and time for transaction insert into payment gateway |
| currency | char | empty or currency value | currency |
| custom1 | alphanumeric | Custom1 | Custom 1 |
| error_code | alphanumeric | Error Code | 0-successful, 2000-pending, otherwise-failed |
| order_id | alphanumeric | empty or orderid value | orderid in the merchant shop system |
| type | char | Type | Type |
2. REQUEST PARAMETERS WITH ORDER-ID
The POST request should contain the following mandatory components:
- Test Credentials
EXAMPLE :
- Diagnose Request & Response with orderid
Diagnose Request
| Field Name | Type | Length | Format | Mandatory? | Description |
|---|---|---|---|---|---|
| merchantid | alphanumeric | 40 characters | ✔ | merchant identification | |
| type | character | ✔ | orderid | ||
| orderid | alphanumeric | max 30 characters | ✔ | orderid in merchant shop system | |
| start_date | alphanumeric | 10 characters | dd.mm.yyyy | ✔ | start time frame |
| end_date | alphanumeric | 10 characters | dd.mm.yyyy | ✔ | end time frame |
| signature | hex | 40 characters | SHA1–Hash | ✔ | Signature Calculation |
Diagnose Response
| Field Name | Type | Content | Description |
|---|---|---|---|
| amount | numeric | empty or amount value | amount |
| creation_date | alphanumeric | creation date | Date and time for transaction insert into payment gateway |
| currency | char | empty or currency value | currency |
| custom1 | alphanumeric | Custom1 | Custom 1 |
| error_code | alphanumeric | Error Code | 0-successful, 2000-pending, otherwise-failed |
| order_id | alphanumeric | empty or orderid value | orderid in the merchant shop system |
| type | char | Type | Type |
3. REQUEST PARAMETERS WITH TYPE = CAPTURE
The POST request should contain the following mandatory components:
- Test Credentials
EXAMPLE :
- Diagnose Request & Response for Capture
Diagnose Request
| Field Name | Type | Length | Format | Mandatory? | Description |
|---|---|---|---|---|---|
| merchantid | alphanumeric | 40 characters | ✔ | merchant identification | |
| type | character | ✔ | capture | ||
| start_date | alphanumeric | 10 characters | dd.mm.yyyy | ✔ | start time frame |
| end_date | alphanumeric | 10 characters | dd.mm.yyyy | ✔ | end time frame |
| signature | hex | 40 characters | SHA1–Hash | ✔ | Signature Calculation |
Diagnose Response
| Field Name | Type | Format | Description |
|---|---|---|---|
| orderid | alphanumeric | empty or orderid value | orderid in the merchant shop system |
| transactionid | numeric | empty or transactionid | payment gateway transaction identification |
| amount | numeric | amount or empty value | number |
| currency | char | empty or currency value | currency |
| booking_date | alphanumeric | dd.mm.yyyy | booking time frame |
| issue_date | alphanumeric | dd.mm.yyyy | issued time frame |
4. REQUEST PARAMETERS WITH TYPE = CHB ( CHARGEBACKS)
The POST request should contain the following mandatory components:
- Test Credentials
EXAMPLE :
- Diagnose Request & Response for Chargeback
Diagnose Request
| Field Name | Type | Length | Format | Mandatory? | Description |
|---|---|---|---|---|---|
| merchantid | alphanumeric | 40 characters | ✔ | merchant identification | |
| type | alphanumeric | ✔ | chb | ||
| transactionid | numeric | empty or transactionid | payment gateway transaction identification | ✔ | numeric |
| start_date | alphanumeric | 10 characters | dd.mm.yyyy | ✔ | start time frame |
| end_date | alphanumeric | 10 characters | dd.mm.yyyy | ✔ | end time frame |
| signature | hex | 40 characters | SHA1–Hash | ✔ | Signature Calculation |
Diagnose Response
| Field Name | Type | Format | Description |
|---|---|---|---|
| orderid | alphanumeric | empty or orderid value | orderid in the merchant shop system |
| transactionid | numeric | empty or transactionid | payment gateway transaction identification |
| amount | numeric | amount or empty value | number |
| currency | char | empty or currency value | currency |
| booking_date | alphanumeric | dd.mm.yyyy | booking time frame |
| issue_date | alphanumeric | dd.mm.yyyy | issued time frame |
5. REQUEST PARAMETERS WITH TYPE = PENDING
The POST request should contain the following mandatory components:
- Test Credentials
EXAMPLE :
- Diagnose Request & Response for Pending
Diagnose Request
| Field Name | Type | Length | Format | Mandatory? | Description |
|---|---|---|---|---|---|
| merchantid | alphanumeric | 40 characters | ✔ | merchant identification | |
| type | character | ✔ | pending | ||
| start_date | alphanumeric | 10 characters | dd.mm.yyyy | ✔ | start time frame |
| end_date | alphanumeric | 10 characters | dd.mm.yyyy | ✔ | end time frame |
| signature | hex | 40 characters | SHA1–Hash | ✔ | Signature Calculation |
Diagnose Response
| Field Name | Type | Format | Description |
|---|---|---|---|
| orderid | alphanumeric | empty or orderid value | orderid in the merchant shop system |
| transactionid | numeric | empty or transactionid | payment gateway transaction identification |
| amount | numeric | amount or empty value | number |
| currency | char | empty or currency value | currency |
| booking_date | alphanumeric | dd.mm.yyyy | booking time frame |
| issue_date | alphanumeric | dd.mm.yyyy | issued time frame |
6. REQUEST PARAMETERS WITH TYPE = FAILED
The POST request should contain the following mandatory components:
- Test Credentials
EXAMPLE :
- Diagnose Request & Response for Failed
Diagnose Request
| Field Name | Type | Length | Format | Mandatory? | Description |
|---|---|---|---|---|---|
| merchantid | alphanumeric | 40 characters | ✔ | merchant identification | |
| type | character | ✔ | failed | ||
| start_date | alphanumeric | 10 characters | dd.mm.yyyy | ✔ | start time frame |
| end_date | alphanumeric | 10 characters | dd.mm.yyyy | ✔ | end time frame |
| signature | hex | 40 characters | SHA1–Hash | ✔ | Signature Calculation |
Diagnose Response
| Field Name | Type | Format | Description |
|---|---|---|---|
| orderid | alphanumeric | empty or orderid value | orderid in the merchant shop system |
| transactionid | numeric | empty or transactionid | payment gateway transaction identification |
| amount | numeric | amount or empty value | number |
| currency | char | empty or currency value | currency |
| booking_date | alphanumeric | dd.mm.yyyy | booking time frame |
| issue_date | alphanumeric | dd.mm.yyyy | issued time frame |
7. REQUEST PARAMETERS WITH TYPE = RETRIEVAL-REQUEST
The POST request should contain the following mandatory components:
- Test Credentials
EXAMPLE :
- Diagnose Request & Response for Retrieval-request
Diagnose Request
| Field Name | Type | Length | Format | Mandatory? | Description |
|---|---|---|---|---|---|
| merchantid | alphanumeric | 40 characters | ✔ | merchant identification | |
| type | character | ✔ | retrieval_request | ||
| start_date | alphanumeric | 10 characters | dd.mm.yyyy | ✔ | start time frame |
| end_date | alphanumeric | 10 characters | dd.mm.yyyy | ✔ | end time frame |
| signature | hex | 40 characters | SHA1–Hash | ✔ | Signature Calculation |
Diagnose Response
| Field Name | Type | Format | Description |
|---|---|---|---|
| orderid | alphanumeric | empty or orderid value | orderid in the merchant shop system |
| transactionid | numeric | empty or transactionid | payment gateway transaction identification |
| amount | numeric | amount or empty value | number |
| currency | char | empty or currency value | currency |
| booking_date | alphanumeric | dd.mm.yyyy | booking time frame |
| issue_date | alphanumeric | dd.mm.yyyy | issued time frame |
8. REQUEST PARAMETERS WITH TYPE = REFUND
The POST request should contain the following mandatory components:
Test Credentials
EXAMPLE :
- Diagnose Request & Response for Refund
Diagnose Request
| Field Name | Type | Length | Format | Mandatory? | Description |
|---|---|---|---|---|---|
| merchantid | alphanumeric | 40 characters | ✔ | merchant identification | |
| type | character | ✔ | refund | ||
| start_date | alphanumeric | 10 characters | dd.mm.yyyy | ✔ | start time frame |
| end_date | alphanumeric | 10 characters | dd.mm.yyyy | ✔ | end time frame |
| signature | hex | 40 characters | SHA1–Hash | ✔ | Signature Calculation |
Diagnose Response
| Field Name | Type | Format | Description |
|---|---|---|---|
| orderid | alphanumeric | empty or orderid value | orderid in the merchant shop system |
| transactionid | numeric | empty or transactionid | payment gateway transaction identification |
| amount | numeric | amount or empty value | number |
| currency | char | empty or currency value | |
| error_code | alphanumeric | Error code | |
| issue_date | alphanumeric | dd.mm.yyyy | |
| refund_date | alphanumeric | dd.mm.yyyy |
Here is a list of the possible types one can get in the response
type=invoce -> authorized
type=booked -> captured
type=refund
type=chargeback
type=retrieval_request
type=partial booking -> partial capture
type=reversal
Note: The end_date is inclusive, e.g. if you want to get a list of all transactions imported into the payment gateway on the 1st of May 2015 for example, your start_date and end_date would both be <01.05.2015>.
Updated about 7 hours ago