refuseChallenge (batch)
To search in the page use Ctrl+F on your keyboard
This function allows a merchant to refuse the challenge on a transaction with orange fraud score. Once the challenge is refused, the transaction is refused.
Request
Required
-
merchantId
- presence
- Required
- Interface version
- 4
- Order
- 2
Identifier of the shop, this value is provided to the merchant by Sogenactif during the shop registration.
-
recordSequence
- presence
- Required
- Interface version
- 4
- Order
- 1
Transaction order in a Sogenactif Office Batch file.
Optional
-
comment
- presence
- Optional
- Interface version
- 4
- Order
- 5
Free commentaire.
-
operationOrigin
- presence
- Optional
- Interface version
- 4
- Order
- 4
Origin of an operation (for example: name of the program), set by the sender of the request (merchant or Sogenactif).This field will be present in the operations log sent to the merchant on a daily basis.
-
s10TransactionReference
- presence
- Optional
- Interface version
- 4
- Order
- 6
Contains the identification of the transaction (to be compliant with Sogenactif 1.0).Contains the data pair (s10TransactionId, s10TransactionIdDAte) which ensures the uniqueness of the transaction 1.0.
Contains
-
s10TransactionId
- presence
- Required
- Interface version
- 4
The merchant can choose between transactionId and transactionReference (by default) to identify his transactions.s10TransactionId is an alternative identifier for the transaction to be compliant with Sogenactif 1.0. The couple s10TransactionId/s10TransactionIdDate ensures the unicity of the transaction.
-
s10TransactionIdDate
- presence
- Optional
- Interface version
- 4
Date of the transaction (expressed in the Sogenactif server time zone).The couple s10TransactionId/s10TransactionIdDate ensures the unicity of the transaction 1.0.The use of this couple instead of transactionReference depends on an option in the merchant configuration.
-
transactionReference
- presence
- Optional
- Interface version
- 4
- Order
- 3
The merchant can choose of referencing his transactions by a transactionId or a transactionReference.transactionReference uniquely identifies a transaction throughout the life of the shop.
Request sample
FILE;request;office;v19
HEADER;023101122334455;2021-12-16+0100;14:26:45+0100;1
REFUSECHALLENGE;10;023101122334456;SIM20220329092501;origin;comment;101;20210329
END;1
<?xml version="1.0" encoding="UTF-8"?>
<file format="office" type="request" version="5">
<header>
<remitterId>023101122334455</remitterId>
<date>2018-07-25+02:00</date>
<time>09:00:00+01:00</time>
<sequence>1</sequence>
</header>
<body>
<refuseChallenge recordSequence="1">
<merchantId>023101122334456</merchantId>
<transactionReference>SIM20220329092501</transactionReference>
<operationOrigin>origin</operationOrigin>
<comment>comment</comment>
<s10TransactionReference>
<s10TransactionId>101</s10TransactionId>
<s10TransactionIdDate>20210329</s10TransactionIdDate>
</s10TransactionReference>
</refuseChallenge>
</body>
<end nbRecord="1" />
</file>
Response
Required
-
merchantId
- presence
- Required
- Interface version
- 4
- Order
- 2
Identifier of the shop, this value is provided to the merchant by Sogenactif during the shop registration.
-
officeBatchResponseCode
- presence
- Required
- Interface version
- 4
- Order
- 8
officeBatchResponseCode completes the result of the processing of a payment request handled by which would be rejected (classic reject responseCode) and contains the field of the payment request that is in error.
List of values
00
- None (all fields are correct)
01
- merchantId error
03
- transactionReference error
04
- merchantTransactionDateTime error
05
- amount error
06
- captureDay error
07
- captureMode error
08
- operationAmount error
09
- operationOrigin error
11
- currencyCode error
12
- customerIpAddress error
13
- customerEmail error
14
- customerId error
16
- orderId error
17
- orderChannel error
18
- transactionOrigin error
19
- returnContext error
20
- fromTransactionReference error
21
- cardExpiryDate error
22
- cardNumber error
23
- cardCSCValue error
24
- cardEffectiveDate error
25
- cardSeqNumber error
26
- paymentMeanBrand error
27
- authorisationId error
28
- merchantWalletId error
29
- paymentMeanId error
30
- paymentPattern error
31
- number error
32
- statementReference error
33
- panType error
34
- mandateId error
35
- valueDate error
36
- paymentMeanAlias error
37
- account error
38
- bankCode error
39
- transactionActors error
45
- Date fields format error
46
- settlementMode error
47
- comment error
48
- validationIndicator error
50
- s10TransactionId error
51
- s10TransactionIdDate error
52
- s10FromTransactionId error
53
- s10FromTransactionIdDate error
54
- fraudData error
55
- riskManagementDynamicParam error
56
- riskManagementDynamicValue error
57
- riskManagementDynamicSettingList error
58
- fraudListReason error
59
- fraudListType error
60
- fraudListLevel error
61
- fraudListElementType error
62
- fraudListElementValue error
63
- lastRecoveryIndicator error
64
- orderContext error
65
- travelContext error
66
- deliveryData error
67
- address error
68
- contact error
69
- cardAuthPolicy error
70
- shoppingCartDetail error
71
- merchantExternalId error
72
- paymentMeansBrandSelectionStatus error
73
- settlementArchivingReference error
74
- settlementMerchantSpecificData error
75
- fromTransactionAcceptor error
80
- Merchant not registered to use Sogenactif Office Batch / Merchant not linked to the remitter declared in the header.
-
recordSequence
- presence
- Required
- Interface version
- 4
- Order
- 1
Transaction order in a Sogenactif Office Batch file.
Optional
-
comment
- presence
- Optional
- Interface version
- 4
- Order
- 5
Free commentaire.
-
newStatus
- presence
- Optional
- Interface version
- 4
- Order
- 7
Status of the transaction updated after a checkout operation. The status of a transaction is described by different keywords which change during the operations it undergoes.
List of values
ABORTED
- Transaction totally aborted
CANCELLED
- Transaction totally cancelled
CAPTURED
- Transaction sent to the bank
CAPTURE_REFUSED
- Capture refused
CREDITED
- Transaction totally refund
ENDED
- Transaction ended
EXPIRED
- Transaction expired
PENDING
- Transaction waiting for the authorisation request response
PREPROD
- Transaction of a merchant which is in the pre-production mode. It cannot be settled.
REFUSED
- Transaction refused
TO_AUTHORIZE
- Transaction waiting for the authorisation request
TO_CAPTURE
- Transaction to send to the bank to debit the user
TO_CHALLENGE
- Transaction with a fraud suspicion
TO_CONFIRM_AUTHOR
- Transaction waiting for confirmation of authorization.
TO_CONFIRM_CAPTURE
- Transaction waiting for confirmation of settlement
TO_CONFIRM_CREDIT
TO_CREDIT
- Transaction to send to the bank to credit the user
TO_REPLAY
- Transaction waiting for a validation with authorization request
TO_VALIDATE
- Transaction waiting for a validation
UNDEFINED
- Transaction status not defined
WAITING_AUTHOR
- Technical status for transaction in a temporarily state waiting for a authorisation batch response
-
operationDateTime
- presence
- Optional
- Interface version
- 4
- Order
- 9
Date and time calculated by Sogenactif on which the transaction has been completed.
-
operationOrigin
- presence
- Optional
- Interface version
- 4
- Order
- 4
Origin of an operation (for example: name of the program), set by the sender of the request (merchant or Sogenactif).This field will be present in the operations log sent to the merchant on a daily basis.
-
responseCode
- presence
- Optional
- Interface version
- 4
- Order
- 10
Sogenactif server response code.
List of values
00
- Operation accepted
01
- For panToToken and tokenToPan methods, partial success
02
- Request of authorized on via telephone with the issuer because of exceeding the card authorization threshold
03
- Invalid merchant contract
05
- Refused authorization
11
- Used for differed check. The PAN is blocked
12
- Invalid transaction. Please check the request parameters
14
- Invalid PAN or payment mean data check is failed (e.g. card number or the visual cryptogram of the card or AVS address)
17
- Customer cancellation
24
- In response to a cash management operation: operation not authorized. The operation you wish to perform is not compliant with the transaction status or another operation is in progress at the same time
- In response to a payment creation: operation rejected, request already carried out with the same data and the same parameters
25
- Transaction unknown by Sogenactif
30
- Format error
34
- Fraud suspicion (seal erroneous)
40
- Function not supported: the operation that you wish to perform is not part of the operation type for which you are authorized
51
- Amount too high
54
- Payment mean expiry date is past
55
- Merchant doesn’t accept prepaid cards
57
- Refund operation refused because the original transaction was subject of an unpaid
60
- Transaction pending
62
- Waiting the confirmation for the transaction (used by PayPal 1.0)
63
- Security rules not observed, transaction stopped
75
- Number of attempts to enter the data of the payment mean from Sogenactif Paypage is exceeded
90
- Service temporarily not available
94
- Duplicated transaction: the transactionReference has been used previously
97
- Session expired (no action from the user during 15 minutes), transaction refused
99
- Temporarily problem with the payment server
-
s10TransactionReference
- presence
- Optional
- Interface version
- 4
- Order
- 6
Contains the identification of the transaction (to be compliant with Sogenactif 1.0).Contains the data pair (s10TransactionId, s10TransactionIdDAte) which ensures the uniqueness of the transaction 1.0.
Contains
-
s10TransactionId
- presence
- Required
- Interface version
- 4
The merchant can choose between transactionId and transactionReference (by default) to identify his transactions.s10TransactionId is an alternative identifier for the transaction to be compliant with Sogenactif 1.0. The couple s10TransactionId/s10TransactionIdDate ensures the unicity of the transaction.
-
s10TransactionIdDate
- presence
- Optional
- Interface version
- 4
Date of the transaction (expressed in the Sogenactif server time zone).The couple s10TransactionId/s10TransactionIdDate ensures the unicity of the transaction 1.0.The use of this couple instead of transactionReference depends on an option in the merchant configuration.
-
transactionReference
- presence
- Optional
- Interface version
- 4
- Order
- 3
The merchant can choose of referencing his transactions by a transactionId or a transactionReference.transactionReference uniquely identifies a transaction throughout the life of the shop.
Response sample
FILE;response;office;v19
HEADER;023101122334455;2021-12-16+0100;14:26:45+0100;1;00;2021-12-16T00:00:00+0100;2021-12-16T00:00:00+0100
REFUSECHALLENGE;10;023101122334456;SIM20220329092501;origin;comment;101;20210329;TO_CAPTURE;00;operationDateTime;00
END;1
<?xml version="1.0" encoding="UTF-8"?>
<file version="v19" format="office" type="response">
<header>
<remitterId>023101122334455</remitterId>
<date>2021-12-16+01:00</date>
<time>14:26:45+01:00</time>
<sequence>1</sequence>
<processingResponseCode>00</processingResponseCode>
<beginProcessTime>2021-12-16T00:00:00+01:00</beginProcessTime>
<endProcessTime>2021-12-16T00:00:00+01:00</endProcessTime>
</header>
<body>
<refuseChallenge recordSequence="1">
<merchantId>023101122334456</merchantId>
<transactionReference>SIM20220329092501</transactionReference>
<operationOrigin>origin</operationOrigin>
<comment>comment</comment>
<s10TransactionReference>
<s10TransactionId>101</s10TransactionId>
<s10TransactionIdDate>20210329</s10TransactionIdDate>
</s10TransactionReference>
<newStatus>TO_CAPTURE</newStatus>
<officeBatchResponseCode>00</officeBatchResponseCode>
<operationDateTime>operationDateTime</operationDateTime>
<responseCode>00</responseCode>
</refuseChallenge>
</body>
<end nbRecord="1" />
</file>
Changelog
Interface version | Data | Attendance | Container |
---|---|---|---|
4 |
comment
|
Request/Response | |
4 |
operationOrigin
|
Request/Response | |
4 |
s10TransactionReference
|
Request/Response | |
4 |
s10TransactionId
|
Container |
s10TransactionReference
|
4 |
s10TransactionIdDate
|
Container |
s10TransactionReference
|
4 |
transactionReference
|
Request/Response | |
4 |
merchantId
|
Request/Response | |
4 |
recordSequence
|
Request/Response | |
4 |
newStatus
|
Response | |
4 |
operationDateTime
|
Response | |
4 |
responseCode
|
Response | |
4 |
officeBatchResponseCode
|
Response |