Format réponse des IPN
Les données transmises en réponse par notre serveur via l'URL de notification à la fin du paiement (IPN) peuvent être différentes en fonction de votre intégration.
Mode redirection
Dans ce cas vous devriez avoir paramétré l'URL de notification de l'API formulaire V1, V2 dans le Back Office Marchand.
Les données seront retournées en POST comme ceci :
vads_amount=50000&vads_auth_mode=FULL&vads_auth_number=3fe82d&vads_auth_result=00&vads_capture_delay=0&vads_card_brand=CB&vads_card_number=510001XXXXXX0114&vads_payment_certificate=a8c3df8db36affe4f3e6554aef041d9fa4213b20&vads_ctx_mode=TEST&vads_currency=978&vads_effective_amount=50000&vads_effective_currency=978&vads_site_id=51872022&vads_trans_date=20250610142542&vads_trans_id=142542&vads_trans_uuid=892926e1e6a34fff99a5bab57dff98d1&vads_initial_issuer_transaction_identifier=5791887434468131&vads_validation_mode=0&vads_version=V2&vads_warranty_result=YES&vads_payment_src=EC&vads_order_id=44&vads_cust_email=juste.leblanc%40lyra-network.com&vads_tid=001&vads_sequence_number=1&vads_acquirer_network=CB&vads_cardholder_card_number=510001XXXXXX0114&vads_contract_used=1454541&vads_trans_status=AUTHORISED&vads_expiry_month=6&vads_expiry_year=2026&vads_cardholder_card_expiry_month=6&vads_cardholder_card_expiry_year=2026&vads_bank_product=MCC&vads_pays_ip=FR&vads_presentation_date=20250610142548&vads_effective_creation_date=20250610142548&vads_occurrence_type=UNITAIRE&vads_operation_type=DEBIT&vads_risk_control=CARD_FRAUD%3DOK%3BECB%3DOK%3BINCONSISTENT_COUNTRIES%3DOK%3BIP_FRAUD%3DOK%3BSUSPECT_COUNTRY%3DOK&vads_result=00&vads_extra_result=00&vads_card_country=GL&vads_language=fr&vads_brand_management=%7B%22userChoice%22%3Afalse%2C%22brandList%22%3A%22CB%7CMASTERCARD%22%2C%22brand%22%3A%22CB%22%7D&vads_hash=df721060befea5370c728e5cc63ee7dff4518a831f42cec6f29f7a04bbe71b3d&vads_url_check_src=PAY&vads_action_mode=INTERACTIVE&vads_payment_config=SINGLE&vads_page_action=PAYMENT&vads_card_product_category=CREDIT&vads_card_nature=CONSUMER&vads_archival_reference_id=L16114254201&vads_threeds_enrolled=Y&vads_threeds_auth_type=FRICTIONLESS&vads_threeds_eci=05&vads_threeds_xid=&vads_threeds_cavvAlgorithm=&vads_threeds_status=Y&vads_threeds_sign_valid=&vads_threeds_error_code=&vads_threeds_exit_status=10&vads_threeds_user_interaction=&vads_threeds_cavv=H**************************%3D&signature=jzmaANhUVAZqyINwhP8ik3Ku%2BBtc64XwYFl0YP%2BoTtQ%3D
Mode embarqué
Dans ce cas vous devriez avoir paramétré l'URL de notification de l'API REST dans le Back Office Marchand.
Les données seront retournées en POST au format JSON comme ceci :
kr-hash-key=password&kr-hash-algorithm=sha256_hmac&kr-answer=%7B%22shopId%22%3A%2251872022%22%2C%22orderCycle%22%3A%22CLOSED%22%2C%22orderStatus%22%3A%22PAID%22%2C%22serverDate%22%3A%222025-06-10T14%3A44%3A27%2B00%3A00%22%2C%22orderDetails%22%3A%7B%22orderTotalAmount%22%3A50000%2C%22orderEffectiveAmount%22%3A50000%2C%22orderPaidAmount%22%3A50000%2C%22orderCurrency%22%3A%22EUR%22%2C%22mode%22%3A%22TEST%22%2C%22orderId%22%3A%2244%22%2C%22metadata%22%3Anull%2C%22updatedDna%22%3Anull%2C%22_type%22%3A%22V4%2FOrderDetails%22%7D%2C%22customer%22%3A%7B%22billingDetails%22%3A%7B%22address%22%3Anull%2C%22category%22%3Anull%2C%22cellPhoneNumber%22%3Anull%2C%22city%22%3Anull%2C%22country%22%3Anull%2C%22district%22%3Anull%2C%22firstName%22%3Anull%2C%22identityCode%22%3Anull%2C%22identityType%22%3Anull%2C%22language%22%3A%22FR%22%2C%22lastName%22%3Anull%2C%22phoneNumber%22%3Anull%2C%22state%22%3Anull%2C%22streetNumber%22%3Anull%2C%22title%22%3Anull%2C%22zipCode%22%3Anull%2C%22legalName%22%3Anull%2C%22_type%22%3A%22V4%2FCustomer%2FBillingDetails%22%7D%2C%22email%22%3A%22juste.leblanc%40lyra-network.com%22%2C%22reference%22%3Anull%2C%22shippingDetails%22%3A%7B%22address%22%3Anull%2C%22address2%22%3Anull%2C%22category%22%3Anull%2C%22city%22%3Anull%2C%22country%22%3Anull%2C%22deliveryCompanyName%22%3Anull%2C%22district%22%3Anull%2C%22firstName%22%3Anull%2C%22identityCode%22%3Anull%2C%22lastName%22%3Anull%2C%22legalName%22%3Anull%2C%22phoneNumber%22%3Anull%2C%22shippingMethod%22%3Anull%2C%22shippingSpeed%22%3Anull%2C%22state%22%3Anull%2C%22streetNumber%22%3Anull%2C%22zipCode%22%3Anull%2C%22_type%22%3A%22V4%2FCustomer%2FShippingDetails%22%7D%2C%22extraDetails%22%3A%7B%22browserAccept%22%3Anull%2C%22fingerPrintId%22%3Anull%2C%22ipAddress%22%3A%22185.244.73.2%22%2C%22browserUserAgent%22%3A%22Mozilla%2F5.0%20%28Windows%20NT%2010.0%3B%20Win64%3B%20x64%3B%20rv%3A139.0%29%20Gecko%2F20100101%20Firefox%2F139.0%22%2C%22_type%22%3A%22V4%2FCustomer%2FExtraDetails%22%7D%2C%22shoppingCart%22%3A%7B%22insuranceAmount%22%3Anull%2C%22shippingAmount%22%3Anull%2C%22taxAmount%22%3Anull%2C%22cartItemInfo%22%3Anull%2C%22_type%22%3A%22V4%2FCustomer%2FShoppingCart%22%7D%2C%22_type%22%3A%22V4%2FCustomer%2FCustomer%22%7D%2C%22transactions%22%3A%5B%7B%22shopId%22%3A%2251872022%22%2C%22uuid%22%3A%221fbe1f7e4ea6411f8fbf1e65735d60c6%22%2C%22amount%22%3A50000%2C%22currency%22%3A%22EUR%22%2C%22paymentMethodType%22%3A%22CARD%22%2C%22paymentMethodToken%22%3Anull%2C%22status%22%3A%22PAID%22%2C%22detailedStatus%22%3A%22AUTHORISED%22%2C%22operationType%22%3A%22DEBIT%22%2C%22effectiveStrongAuthentication%22%3A%22DISABLED%22%2C%22creationDate%22%3A%222025-06-10T14%3A44%3A18%2B00%3A00%22%2C%22errorCode%22%3Anull%2C%22errorMessage%22%3Anull%2C%22detailedErrorCode%22%3Anull%2C%22detailedErrorMessage%22%3Anull%2C%22metadata%22%3Anull%2C%22transactionDetails%22%3A%7B%22liabilityShift%22%3A%22YES%22%2C%22effectiveAmount%22%3A50000%2C%22effectiveCurrency%22%3A%22EUR%22%2C%22creationContext%22%3A%22CHARGE%22%2C%22cardDetails%22%3A%7B%22paymentSource%22%3A%22EC%22%2C%22manualValidation%22%3A%22NO%22%2C%22expectedCaptureDate%22%3A%222025-06-10T14%3A44%3A18%2B00%3A00%22%2C%22effectiveBrand%22%3A%22CB%22%2C%22pan%22%3A%22510001XXXXXX0114%22%2C%22expiryMonth%22%3A6%2C%22expiryYear%22%3A2026%2C%22country%22%3A%22GL%22%2C%22issuerCode%22%3Anull%2C%22issuerName%22%3Anull%2C%22effectiveProductCode%22%3A%22MCC%22%2C%22legacyTransId%22%3A%22144417%22%2C%22legacyTransDate%22%3A%222025-06-10T14%3A44%3A17%2B00%3A00%22%2C%22paymentMethodSource%22%3A%22NEW%22%2C%22authorizationResponse%22%3A%7B%22amount%22%3A50000%2C%22currency%22%3A%22EUR%22%2C%22authorizationDate%22%3A%222025-06-10T14%3A44%3A27%2B00%3A00%22%2C%22authorizationNumber%22%3A%223fee94%22%2C%22authorizationResult%22%3A%220%22%2C%22authorizationMode%22%3A%22FULL%22%2C%22_type%22%3A%22V4%2FPaymentMethod%2FDetails%2FCards%2FCardAuthorizationResponse%22%7D%2C%22captureResponse%22%3A%7B%22refundAmount%22%3Anull%2C%22refundCurrency%22%3Anull%2C%22captureDate%22%3Anull%2C%22captureFileNumber%22%3Anull%2C%22effectiveRefundAmount%22%3Anull%2C%22effectiveRefundCurrency%22%3Anull%2C%22_type%22%3A%22V4%2FPaymentMethod%2FDetails%2FCards%2FCardCaptureResponse%22%7D%2C%22threeDSResponse%22%3A%7B%22authenticationResultData%22%3A%7B%22transactionCondition%22%3Anull%2C%22enrolled%22%3Anull%2C%22status%22%3Anull%2C%22eci%22%3Anull%2C%22xid%22%3Anull%2C%22cavvAlgorithm%22%3Anull%2C%22cavv%22%3Anull%2C%22signValid%22%3Anull%2C%22brand%22%3Anull%2C%22_type%22%3A%22V4%2FPaymentMethod%2FDetails%2FCards%2FCardAuthenticationResponse%22%7D%2C%22_type%22%3A%22V4%2FPaymentMethod%2FDetails%2FCards%2FThreeDSResponse%22%7D%2C%22authenticationResponse%22%3A%7B%22id%22%3A%226d1cb4b6-9da4-44c3-81b5-286360355ae9%22%2C%22operationSessionId%22%3Anull%2C%22authenticationDateTime%22%3A%222025-06-10T14%3A44%3A27.055Z%22%2C%22protocol%22%3A%7B%22name%22%3A%22THREEDS%22%2C%22version%22%3A%222.2.0%22%2C%22network%22%3A%22MASTERCARD%22%2C%22challengePreference%22%3A%22NO_PREFERENCE%22%2C%22simulation%22%3Atrue%2C%22_type%22%3A%22V4%2FCharge%2FAuthenticate%2FProtocol%22%7D%2C%22value%22%3A%7B%22authenticationType%22%3A%22FRICTIONLESS%22%2C%22authenticationId%22%3A%7B%22authenticationIdType%22%3A%22dsTransId%22%2C%22value%22%3A%225d25ada6-74ad-4e6e-95ea-5663a5f70982%22%2C%22_type%22%3A%22V4%2FCharge%2FAuthenticate%2FAuthenticationId%22%7D%2C%22authenticationValue%22%3A%7B%22authenticationValueType%22%3A%22AAV%22%2C%22value%22%3A%22j**************************%3D%22%2C%22_type%22%3A%22V4%2FCharge%2FAuthenticate%2FAuthenticationValue%22%7D%2C%22status%22%3A%22SUCCESS%22%2C%22commerceIndicator%22%3A%2205%22%2C%22extension%22%3A%7B%22authenticationType%22%3A%22THREEDS_V2%22%2C%22challengeCancelationIndicator%22%3Anull%2C%22cbScore%22%3Anull%2C%22cbAvalgo%22%3Anull%2C%22cbExemption%22%3Anull%2C%22paymentUseCase%22%3Anull%2C%22threeDSServerTransID%22%3A%226d1cb4b6-9da4-44c3-81b5-286360355ae9%22%2C%22dsTransID%22%3A%225d25ada6-74ad-4e6e-95ea-5663a5f70982%22%2C%22acsTransID%22%3A%22945b228e-8091-4cbd-acb0-e1ccf1a51779%22%2C%22sdkTransID%22%3Anull%2C%22transStatus%22%3A%22SUCCESSFUL%22%2C%22transStatusReason%22%3Anull%2C%22requestedExemption%22%3A%22ISSUER_TRA%22%2C%22requestorName%22%3A%22Lyra%20Authentication%20Server_My%20Shop%22%2C%22cardHolderInfo%22%3Anull%2C%22dataOnlyStatus%22%3Anull%2C%22dataOnlyDecision%22%3Anull%2C%22dataOnlyScore%22%3Anull%2C%22complementaryAuthenticationType%22%3A%22DEFAULT%22%2C%22_type%22%3A%22V4%2FCharge%2FAuthenticate%2FAuthenticationResultExtensionThreedsV2%22%7D%2C%22reason%22%3A%7B%22code%22%3Anull%2C%22message%22%3Anull%2C%22_type%22%3A%22V4%2FCharge%2FAuthenticate%2FAuthenticationResultReason%22%7D%2C%22_type%22%3A%22V4%2FCharge%2FAuthenticate%2FAuthenticationResult%22%7D%2C%22merchant%22%3Anull%2C%22_type%22%3A%22V4%2FAuthenticationResponseData%22%7D%2C%22installmentNumber%22%3Anull%2C%22installmentCode%22%3Anull%2C%22markAuthorizationResponse%22%3A%7B%22amount%22%3Anull%2C%22currency%22%3Anull%2C%22authorizationDate%22%3Anull%2C%22authorizationNumber%22%3Anull%2C%22authorizationResult%22%3Anull%2C%22_type%22%3A%22V4%2FPaymentMethod%2FDetails%2FCards%2FMarkAuthorizationResponse%22%7D%2C%22cardHolderName%22%3Anull%2C%22cardHolderPan%22%3A%22510001XXXXXX0114%22%2C%22cardHolderExpiryMonth%22%3A6%2C%22cardHolderExpiryYear%22%3A2026%2C%22identityDocumentNumber%22%3Anull%2C%22identityDocumentType%22%3Anull%2C%22initialIssuerTransactionIdentifier%22%3A%221128030782311298%22%2C%22productCategory%22%3A%22CREDIT%22%2C%22nature%22%3A%22CONSUMER_CARD%22%2C%22sequenceType%22%3A%22NONE%22%2C%22_type%22%3A%22V4%2FPaymentMethod%2FDetails%2FCardDetails%22%7D%2C%22paymentMethodDetails%22%3A%7B%22id%22%3A%22510001XXXXXX0114%22%2C%22paymentSource%22%3A%22EC%22%2C%22manualValidation%22%3A%22NO%22%2C%22expectedCaptureDate%22%3A%222025-06-10T14%3A44%3A18%2B00%3A00%22%2C%22effectiveBrand%22%3A%22CB%22%2C%22expiryMonth%22%3A6%2C%22expiryYear%22%3A2026%2C%22country%22%3A%22GL%22%2C%22issuerCode%22%3Anull%2C%22issuerName%22%3Anull%2C%22effectiveProductCode%22%3A%22MCC%22%2C%22legacyTransId%22%3A%22144417%22%2C%22legacyTransDate%22%3A%222025-06-10T14%3A44%3A17%2B00%3A00%22%2C%22paymentMethodSource%22%3A%22NEW%22%2C%22authorizationResponse%22%3A%7B%22amount%22%3A50000%2C%22currency%22%3A%22EUR%22%2C%22authorizationDate%22%3A%222025-06-10T14%3A44%3A27%2B00%3A00%22%2C%22authorizationNumber%22%3A%223fee94%22%2C%22authorizationResult%22%3A%220%22%2C%22authorizationMode%22%3A%22FULL%22%2C%22_type%22%3A%22V4%2FPaymentMethod%2FDetails%2FCards%2FCardAuthorizationResponse%22%7D%2C%22captureResponse%22%3A%7B%22refundAmount%22%3Anull%2C%22refundCurrency%22%3Anull%2C%22captureDate%22%3Anull%2C%22captureFileNumber%22%3Anull%2C%22effectiveRefundAmount%22%3Anull%2C%22effectiveRefundCurrency%22%3Anull%2C%22_type%22%3A%22V4%2FPaymentMethod%2FDetails%2FCards%2FCardCaptureResponse%22%7D%2C%22authenticationResponse%22%3A%7B%22id%22%3A%226d1cb4b6-9da4-44c3-81b5-286360355ae9%22%2C%22operationSessionId%22%3Anull%2C%22authenticationDateTime%22%3A%222025-06-10T14%3A44%3A27.055Z%22%2C%22protocol%22%3A%7B%22name%22%3A%22THREEDS%22%2C%22version%22%3A%222.2.0%22%2C%22network%22%3A%22MASTERCARD%22%2C%22challengePreference%22%3A%22NO_PREFERENCE%22%2C%22simulation%22%3Atrue%2C%22_type%22%3A%22V4%2FCharge%2FAuthenticate%2FProtocol%22%7D%2C%22value%22%3A%7B%22authenticationType%22%3A%22FRICTIONLESS%22%2C%22authenticationId%22%3A%7B%22authenticationIdType%22%3A%22dsTransId%22%2C%22value%22%3A%225d25ada6-74ad-4e6e-95ea-5663a5f70982%22%2C%22_type%22%3A%22V4%2FCharge%2FAuthenticate%2FAuthenticationId%22%7D%2C%22authenticationValue%22%3A%7B%22authenticationValueType%22%3A%22AAV%22%2C%22value%22%3A%22j**************************%3D%22%2C%22_type%22%3A%22V4%2FCharge%2FAuthenticate%2FAuthenticationValue%22%7D%2C%22status%22%3A%22SUCCESS%22%2C%22commerceIndicator%22%3A%2205%22%2C%22extension%22%3A%7B%22authenticationType%22%3A%22THREEDS_V2%22%2C%22challengeCancelationIndicator%22%3Anull%2C%22cbScore%22%3Anull%2C%22cbAvalgo%22%3Anull%2C%22cbExemption%22%3Anull%2C%22paymentUseCase%22%3Anull%2C%22threeDSServerTransID%22%3A%226d1cb4b6-9da4-44c3-81b5-286360355ae9%22%2C%22dsTransID%22%3A%225d25ada6-74ad-4e6e-95ea-5663a5f70982%22%2C%22acsTransID%22%3A%22945b228e-8091-4cbd-acb0-e1ccf1a51779%22%2C%22sdkTransID%22%3Anull%2C%22transStatus%22%3A%22SUCCESSFUL%22%2C%22transStatusReason%22%3Anull%2C%22requestedExemption%22%3A%22ISSUER_TRA%22%2C%22requestorName%22%3A%22Lyra%20Authentication%20Server_My%20Shop%22%2C%22cardHolderInfo%22%3Anull%2C%22dataOnlyStatus%22%3Anull%2C%22dataOnlyDecision%22%3Anull%2C%22dataOnlyScore%22%3Anull%2C%22complementaryAuthenticationType%22%3A%22DEFAULT%22%2C%22_type%22%3A%22V4%2FCharge%2FAuthenticate%2FAuthenticationResultExtensionThreedsV2%22%7D%2C%22reason%22%3A%7B%22code%22%3Anull%2C%22message%22%3Anull%2C%22_type%22%3A%22V4%2FCharge%2FAuthenticate%2FAuthenticationResultReason%22%7D%2C%22_type%22%3A%22V4%2FCharge%2FAuthenticate%2FAuthenticationResult%22%7D%2C%22merchant%22%3Anull%2C%22_type%22%3A%22V4%2FAuthenticationResponseData%22%7D%2C%22installmentNumber%22%3Anull%2C%22installmentCode%22%3Anull%2C%22markAuthorizationResponse%22%3A%7B%22amount%22%3Anull%2C%22currency%22%3Anull%2C%22authorizationDate%22%3Anull%2C%22authorizationNumber%22%3Anull%2C%22authorizationResult%22%3Anull%2C%22_type%22%3A%22V4%2FPaymentMethod%2FDetails%2FCards%2FMarkAuthorizationResponse%22%7D%2C%22cardHolderName%22%3Anull%2C%22cardHolderPan%22%3A%22510001XXXXXX0114%22%2C%22cardHolderExpiryMonth%22%3A6%2C%22cardHolderExpiryYear%22%3A2026%2C%22identityDocumentNumber%22%3Anull%2C%22identityDocumentType%22%3Anull%2C%22initialIssuerTransactionIdentifier%22%3A%221128030782311298%22%2C%22_type%22%3A%22V4%2FPaymentMethod%2FDetails%2FPaymentMethodDetails%22%7D%2C%22acquirerDetails%22%3Anull%2C%22fraudManagement%22%3A%7B%22riskControl%22%3A%5B%7B%22name%22%3A%22CARD_FRAUD%22%2C%22result%22%3A%22OK%22%2C%22_type%22%3A%22V4%2FPaymentMethod%2FDetails%2FRisk%2FRiskControl%22%7D%2C%7B%22name%22%3A%22ECB%22%2C%22result%22%3A%22OK%22%2C%22_type%22%3A%22V4%2FPaymentMethod%2FDetails%2FRisk%2FRiskControl%22%7D%2C%7B%22name%22%3A%22INCONSISTENT_COUNTRIES%22%2C%22result%22%3A%22OK%22%2C%22_type%22%3A%22V4%2FPaymentMethod%2FDetails%2FRisk%2FRiskControl%22%7D%2C%7B%22name%22%3A%22SUSPECT_COUNTRY%22%2C%22result%22%3A%22OK%22%2C%22_type%22%3A%22V4%2FPaymentMethod%2FDetails%2FRisk%2FRiskControl%22%7D%2C%7B%22name%22%3A%22IP_FRAUD%22%2C%22result%22%3A%22OK%22%2C%22_type%22%3A%22V4%2FPaymentMethod%2FDetails%2FRisk%2FRiskControl%22%7D%5D%2C%22riskAnalysis%22%3A%5B%5D%2C%22riskAssessments%22%3Anull%2C%22_type%22%3A%22V4%2FPaymentMethod%2FDetails%2FFraudManagement%22%7D%2C%22subscriptionDetails%22%3A%7B%22subscriptionId%22%3Anull%2C%22_type%22%3A%22V4%2FPaymentMethod%2FDetails%2FSubscriptionDetails%22%7D%2C%22parentTransactionUuid%22%3Anull%2C%22mid%22%3A%221454541%22%2C%22sequenceNumber%22%3A1%2C%22taxAmount%22%3Anull%2C%22preTaxAmount%22%3Anull%2C%22taxRate%22%3Anull%2C%22externalTransactionId%22%3Anull%2C%22dcc%22%3Anull%2C%22nsu%22%3Anull%2C%22tid%22%3A%22001%22%2C%22acquirerNetwork%22%3A%22CB%22%2C%22taxRefundAmount%22%3Anull%2C%22userInfo%22%3Anull%2C%22paymentMethodTokenPreviouslyRegistered%22%3Anull%2C%22occurrenceType%22%3A%22UNITAIRE%22%2C%22archivalReferenceId%22%3A%22L16114441701%22%2C%22useCase%22%3Anull%2C%22wallet%22%3Anull%2C%22_type%22%3A%22V4%2FTransactionDetails%22%7D%2C%22_type%22%3A%22V4%2FPaymentTransaction%22%7D%5D%2C%22subMerchantDetails%22%3Anull%2C%22_type%22%3A%22V4%2FPayment%22%7D&kr-answer-type=V4%2FPayment&kr-hash=2523fd1e9ab4249e5f6eeebe1ae0631a09128e89c3255d7484c96ab3f6da9ea5&kr-src=PAY