{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars/payment_api_2_0_sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"422 - Credit Risk","description":"The specifications of Ratepay's APIs for easy payment transactions.","siteUrl":"https://docs.ratepay.com","keywords":"Ratepay developer portal, Ratepay api portal, Ratepay api reference docs","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"422---credit-risk","__idx":0},"children":["422 - Credit Risk"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"description","__idx":1},"children":["Description"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When Ratepay declines a payment for credit-risk reasons under CCD2, the response will have the HTTP status code 422, with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CREDIT_RISK"]}," as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["decline.category"]},"."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the returned ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["decline.message"]}," for the buyer's language when present."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The text can contain named placeholders; match each placeholder to an entry in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["links"]}," by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rel"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Render its supplied label and URL as a link in your frontend."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Note:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Its content differs by country and language."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not replace the full explanation with a generic decline text."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Other decline categories can have different response shapes."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We recommend that you limit the number of transaction attempts for this buyer when you receive this decline category to one per 24 hours."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example","__idx":2},"children":["Example"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can test the credit-decline informations by placing a B2C order using"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["credit_risk_data@ratepay.com"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["credit_risk_score@ratepay.com"]}," as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["when sending the Authorize transaction request on the integration environment."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"_links\": {\n    \"self\": {\n      \"href\": \"https://api-integration.ratepay.com/transaction/management/v2/transactions/EXAMPLE_TRANSACTION_ID\"\n    }\n  },\n  \"created\": \"2026-09-27T14:15:22Z\",\n  \"decline\": {\n    \"category\": \"CREDIT_RISK\",\n    \"message\": {\n      \"en\": {\n        \"text\": \"Our partner Ratepay ran a credit check with SCHUFA Holding AG, using your name, address and, if provided, date of birth. The score came back at 5700, below what this transaction requires. To exercise your {data_protection_rights} or to request a human review of the decision, {contact_ratepay}.\",\n        \"links\": [\n          {\n            \"rel\": \"data_protection_rights\",\n            \"href\": \"https://www.ratepay.com/en/ratepay-data-privacy-statement\",\n            \"label\": \"Data Protection Rights\"\n          },\n          {\n            \"rel\": \"contact_ratepay\",\n            \"href\": \"https://www.ratepay.com/en/shoppers/contact\",\n            \"label\": \"Contact Ratepay\"\n          }\n        ]\n      }\n    }\n  },\n  \"ratepay_transaction_id\": \"EXAMPLE_TRANSACTION_ID\",\n  \"result\": \"DECLINED\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"possible-api-calls","__idx":3},"children":["Possible API Calls"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Authorization"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Incremental Authorization"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"buyer-messages","__idx":4},"children":["Buyer Messages"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Online shop:"]}," Show the message and links on the buyer's result screen. Keep another available payment method accessible."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MOTO:"]}," Show the message and links in the staff order-entry flow so the employee can communicate them and offer another method."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POS:"]}," Show them in the staff result so the employee can explain the decision and review options."]}]}]},"headings":[{"value":"422 - Credit Risk","id":"422---credit-risk","depth":1},{"value":"Description","id":"description","depth":2},{"value":"Example","id":"example","depth":2},{"value":"Possible API Calls","id":"possible-api-calls","depth":2},{"value":"Buyer Messages","id":"buyer-messages","depth":2}],"frontmatter":{"seo":{"title":"422 - Credit Risk"}},"lastModified":"2026-10-15T21:23:05.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/developer/api_integration/payment_2.0/declines/422_credit_risk","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}