Processing data specific to the response of payment with
Characteristics of a split payment:
When paying, the buyer pays for a part of the purchase with a meal voucher and the remainder with a bank card.
The payment will consist of N sequences detailed in the vads_payment_seq field:
- All the transactions of a split payment are combined within a payment sequence.
- All the transactions of a payment sequence have the same transaction identifier, but a different sequence number.
- The number of the first transaction of the sequence is 1, the number of the second is 2, etc.
The life cycle of a successful Titre-Restaurant transaction:
When the authorization request has been accepted, the status of the Titre-Restaurant transaction changes to "waiting for capture". This state is defined by the AUTHORISED value specified in the vads_trans_status field. The transaction is accepted and will be automatically transmitted to the issuer for refund on D+1.
Once the transaction has been transmitted to the issuer, its status changes to CAPTURED.
List of fields specific to the response of a meal voucher payment
The Instant Payment Notification URL will contain the following information:
Field name | Description | Value |
---|---|---|
vads_page_action | Completed operation |
PAYMENT Payment made without token |
vads_trans_status | Status of the payment |
|
vads_card_brand | Payment type | Case of payment made using only a Titre-Restaurant card:
Case of a split payment (a Titre-Restaurant card is a complementary payment method):
|
vads_payment_seq | Details of the split payment sequence | See explanations and table below. |
Details of the vads_payment_seq field
All the transactions of a split payment are combined within a payment sequence.
All the transactions of a payment sequence have the same transaction identifier, but a different sequence number. The number of the first transaction of the sequence is 1, the number of the second is 2, etc.
The vads_payment_seq field (json format) describes the split payment sequence. It contains:
- "trans_id": identifier of the transaction received in the vads_trans_id field of the payment form.
- "transaction": transaction table of the sequence.
Note: canceled and declined transactions are also displayed in the table.
Note: the field order in JSON is not necessarily the same as in your programming language.
Each transaction of the sequence contains the following elements:
Name of the parameter | Description | ||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
amount |
Amount of the payment sequence. |
||||||||||||||||||||||||||||||
operation_type |
Debit operation. |
||||||||||||||||||||||||||||||
auth_number |
Authorization number. Example: 949478 |
||||||||||||||||||||||||||||||
auth_result | Return code of the authorization request. | ||||||||||||||||||||||||||||||
capture_delay | Delay before the capture (in days).
|
||||||||||||||||||||||||||||||
card_brand |
Used payment method. For meal voucher payments, this parameter can be set to:
See the Payment Gateway Implementation Guide available in our online documentation archive to see the complete list of card types. |
||||||||||||||||||||||||||||||
card_number | Payment method number | ||||||||||||||||||||||||||||||
expiry_month |
Expiry month of the payment method. |
||||||||||||||||||||||||||||||
expiry_year |
Expiry month year of the payment method. |
||||||||||||||||||||||||||||||
payment_certificate | Payment certificate. | ||||||||||||||||||||||||||||||
contract_used | Contract used for the payment. | ||||||||||||||||||||||||||||||
identifier | Unique identifier (token) associated with a payment method. | ||||||||||||||||||||||||||||||
identifier_status | Present only if the requested action corresponds to token creation or update. Possible values:
|
||||||||||||||||||||||||||||||
presentation_date |
For a payments by card, this parameter is the requested capture date (ISO 8601 format). For a payment by meal voucher processed by the Conecs scheme, this parameter value corresponds to the date of the order. |
||||||||||||||||||||||||||||||
trans_id | Transaction number. | ||||||||||||||||||||||||||||||
ext_trans_id | Parameter absent for bank card and meal voucher payments. | ||||||||||||||||||||||||||||||
trans_uuid | Unique reference generated by the payment gateway after a payment transaction has been created. Provides a guarantee that each transaction is unique. |
||||||||||||||||||||||||||||||
extra_result | Numerical code of risk assessment result.
|
||||||||||||||||||||||||||||||
sequence_number | Sequence number. | ||||||||||||||||||||||||||||||
trans_status | Transaction status. |
vads_payment_seq :{ "trans_id":"011028", "transactions":[ { "amount":"1000", "operation_type":"DEBIT", "auth_number":"3feee9", "auth_result":"10", "capture_delay":"0", "card_brand":"APETIZ", "card_number":"507596XXXXXX0028", "expiry_month":"6", "expiry_year":"2019", "payment_certificate":"90c0a80da281a5880675232bc007d19c799bdd01", "contract_used":"1999011", "presentation_date":"2018-03-22T11:35:10Z", "trans_id":"012224", "trans_uuid":"b2a059f4b0164252844ccef94dcd3aa2", "sequence_number":"1", "trans_status":"AUTHORISED" }, { "amount":"3504", "operation_type":"DEBIT", "auth_number":"3fb881", "auth_result":"00", "capture_delay":"0", "card_brand":"CB", "card_number":"497010XXXXXX0014", "expiry_month":"6", "expiry_year":"2019", "payment_certificate":"1395fe45833753c8f206f613a4fa237e41fea7a8", "contract_used":"5785350", "presentation_date":"2018-03-22T11:35:14Z", "trans_id":"012224", "trans_uuid":"294897a937da4d7db48a222b727bb1e5", "sequence_number":"2", "trans_status":"AUTHORISED" }] }
vads_payment_seq :{ "trans_id":"011029", "transactions":[ { "amount":"1000", "operation_type":"DEBIT", "auth_number":"3fe235", "auth_result":"57" "capture_delay":"0", "card_brand":"SODEXO", "card_number":"507597XXXXXX0020", "expiry_month":"12", "expiry_year":"2020", "payment_certificate":"74db5c03b6cba5c763e520648b0071768f5d806f", "contract_used":"1999011", "presentation_date":"2018-01-29T14:34:20Z", "trans_id":"011028", "trans_uuid":"3670c65bb8e040d2996474b809e0c1ac", "sequence_number":"1", "trans_status":"REFUSED" }, { "amount":"1000", "operation_type":"DEBIT", "auth_number":"3fe235", "auth_result":"10" "capture_delay":"0", "card_brand":"SODEXO", "card_number":"507597XXXXXX0747", "expiry_month":"11", "expiry_year":"2020", "payment_certificate":"d396a0a9601dc88d23bba2224a41fe8c32676e2f", "contract_used":"1999011", "presentation_date":"2018-01-29T14:34:20Z", "trans_id":"011028", "trans_uuid":"5f5edf3fe22f4dbfbd53152417275b4c", "sequence_number":"2", "trans_status":"CANCELLED" }, { "amount":"1000", "operation_type":"DEBIT", "auth_number":"3fe235", "auth_result":"10" "capture_delay":"0", "card_brand":"APETIZ", "card_number":"507596XXXXXX0421", "expiry_month":"10", "expiry_year":"2020", "payment_certificate":"010a2db1ef864d6584424c41512dd9ad678c785e", "contract_used":"1999011", "presentation_date":"2018-01-29T14:34:20Z", "trans_id":"011028", "trans_uuid":"2cfee86ecf5e433ab0db82dc7b601db6", "sequence_number":"3", "trans_status":"AUTHORISED" }, { "amount":"3222", "operation_type":"DEBIT", "auth_number":"3fc022", "auth_result":"00" "capture_delay":"0", "card_brand":"CB", "card_number":"497010XXXXXX0014", "expiry_month":"6", "expiry_year":"2019", "payment_certificate":"d0739983a70cd0267f1b50f6377bada4f1d6857e", "contract_used":"5785350", "presentation_date":"2018-01-29T14:34:35Z", "trans_id":"011028", "trans_uuid":"60f3c247d0a842498cfc38421d60b391", "sequence_number":"4", "trans_status":"AUTHORISED" }] }
Example of JSON format for a transaction made using accepted Titre-Restaurant and CB cards with registration of both cards:
vads_payment_seq :{ "trans_id":"012224", "transactions":[ { "amount":"1000", "operation_type":"DEBIT", "auth_number":"3fd375", "auth_result":"10", "capture_delay":"0", "card_brand":"APETIZ", "card_number":"507596XXXXXX0028", "expiry_month":"6", "expiry_year":"2019", "payment_certificate":"90c0a80da281a5880675232bc007d19c799bdd01", "contract_used":"1999011", "identifier":"0b621d0da984414b86193502cfd010ca", "identifier_status":"CREATED", "presentation_date":"2018-04-19T07:05:03Z", "trans_id":"257349", "trans_uuid":"d97a7a374e5e41359f3c97649f5777ae", "sequence_number":"1", "trans_status":"AUTHORISED" }, { "amount":"3504", "operation_type":"DEBIT", "auth_number":"3fd375", "auth_result":"00", "capture_delay":"0", "card_brand":"CB", "card_number":"497010XXXXXX0014", "expiry_month":"6", "expiry_year":"2019", "payment_certificate":"db4cff0dce146571d7b2720f2b716a0d7c72b8f4", "contract_used":"5785350", "identifier":"432870832da94e73b39a6999475d4d27", "identifier_status":"CREATED", "presentation_date":"2018-04-19T07:05:45Z", "trans_id":"257349", "trans_uuid":"775769b823ad4cf3a16a41cb4f3401d5", "sequence_number":"2", "trans_status":"AUTHORISED" }] }
[...] vads_page_action :PAYMENT vads_currency :978 vads_payment_src :EC vads_cust_email :example@example.com vads_card_brand:SODEXO vads_order_id :861-0097 vads_capture_delay :0 vads_auth_number : vads_currency :978 vads_payment_config :SINGLE vads_language :fr vads_risk_control :CARD_FRAUD=OK vads_operation_type :DEBIT vads_card_number :507597XXXXXX0033 vads_result :00 vads_trans_uuid :fd7c645cf082466cb635699b70ba690f vads_trans_date :20180129143412 vads_ctx_mode :TEST vads_action_mode :INTERACTIVE vads_amount :1900 vads_version :V2 vads_presentation_date :20180129143435 vads_trans_status :AUTHORISED vads_pays_ip :FR vads_trans_id :011028 vads_auth_result :00 vads_site_id :12345678 [...] signature :d67320df4aaaae5ef1e8381785cddb116d7c6aa3