This service can be used by the Payment Connector to initiate a Reconciliation via an online channel.
COMPATIBILITY
Type | Compatibility |
---|---|
Card present (CP) | No |
Card not present (CNP) | Yes |
REQUEST
Type | Endpoint |
---|---|
POST | /payment/v1/interface/terminalprovider/reconciliation |
PARAMETERS
Name |
Type |
Description |
CP mandatory |
CNP mandatory |
Example |
MessageHeader |
defined data structure |
Message header of the Sale to POI protocol message |
|
Y |
|
MessageClass |
Enum |
Class of the message |
|
Y |
Service |
MessageCategory |
Enum |
Category of the message. |
|
Y |
Reconciliation |
MessageType |
Enum |
Type of message of the Sale to POI protocol |
|
Y |
Request |
ServiceID |
TextString {1,10} |
Identification of a message pair, which processes a transaction |
|
Y |
H9732FO20102669461REC |
SaleID |
TextString |
Identification of a Sale System or a Sale Terminal for the Sale to POI protocol |
|
Y |
w-eu-h0416FLS1 |
POIID |
TextString
|
Identification of a POI System or a POI Terminal for the Sale to POI protocol |
|
Y |
CAP |
ReconciliationRequest |
defined data structure |
Content of the Reconciliation Request message |
|
Y |
|
ReconciliationType |
String |
AcquirerReconciliation – used to trigger reconciliation between POI and host SaleReconciliation – used to close the business day of the sale system |
|
Y |
SaleReconciliation |
RESPONSE
Name |
Type |
Description |
CP mandatory |
CNP mandatory |
Example |
MessageHeader |
defined data structure
|
|
|
Y |
|
MessageClass |
Enum |
Copy from request |
|
Y |
Service |
MessageCategory |
Enum |
Payment |
|
Y |
Reconciliation |
MessageType |
Enum |
Response |
|
Y |
Response |
ServiceID |
TextString {1,10}
|
Copy from request |
|
Y |
H9732FO20102669461REC |
SaleID |
TextString |
Copy from request |
|
Y |
w-eu-h0867FLS1 |
POIID |
TextString
|
Terminal Identification Set to Terminal Identification |
|
Y |
CNP: CAP |
ReconciliationResponse |
defined data structure |
Content of the Payment Response message |
|
Y |
|
Response |
defined data structure |
Result of a message request processing.
|
|
Y |
|
Result |
Enum |
Transaction Result
|
|
Y |
Success
|
ErrorCondition |
Enum |
If the result is set to Failure then the condition should be part of the message.
Transaction Result If Transaction Result = VOICE AUTHORISATION, set ErrorCondition = "Referral" |
|
N |
DeviceOut |
AdditionnalResponse |
TextString |
Processing Status, Nok Reason, Terminal Verification Results (TVR) and Transaction Status Information (TSI).
Set as TLV structure |
|
N |
|
ReconciliationType |
defined data structure |
Data related to the Sale System |
|
Y |
|
EXAMPLE 1
This example show request/response for a card not present transaction.
Example of request :
{ "SaleToPOIRequest": { "MessageHeader": { "MessageCategory": "Reconciliation", "MessageClass": "Service", "MessageType": "Request", "POIID": "CAP", "SaleID": "S-RF-H9732-FLS1", "ServiceID": "H9732FO20102669461REC" }, "ReconciliationRequest": { "ReconciliationType": "SaleReconciliation" } } } |
Example of response :
{ "SaleToPOIResponse": { "MessageHeader": { "MessageCategory": "Reconciliation", "MessageClass": "Service", "MessageType": "Response", "POIID": "CAP", "SaleID": "S-RF-H9732-FLS1", "ServiceID": "H9732FO20102669461REC" }, "ReconciliationResponse": { "ReconciliationType": "", "Response": { "Result": "Success" } } } } |