Diese Dokumentation erkl\u00e4rt, wie Sie RiskPayGo in Ihre Website oder Anwendung integrieren, um Zahlungen zu erstellen, den K\u00e4ufer zur Kasse weiterzuleiten und eine endg\u00fcltige Statusbest\u00e4tigung per Webhook zu erhalten.<\/p>\n
Die Integration muss \u00fcber Ihr Backend erfolgen. Es wird nicht empfohlen, Zugangsdaten oder sensible Logik im Frontend offenzulegen.<\/p>\n
Bevor Sie beginnen, ben\u00f6tigen Sie ein genehmigtes und aktives H\u00e4ndlerkonto bei RiskPayGo. Au\u00dferdem ben\u00f6tigen Sie Ihre Integrationsdaten und m\u00fcssen sicherstellen, dass die Domain, von der Sie Zahlungen empfangen m\u00f6chten, in Ihrem Konto freigeschaltet ist.<\/p>\n
Die Daten, die Sie ben\u00f6tigen, sind Ihre Die Basis-URL lautet wie folgt:<\/p>\n Alle API-Anfragen m\u00fcssen authentifiziert werden. Dazu m\u00fcssen Sie das private Token im Header angeben. Die erforderlichen \u00dcberschriften lauten wie folgt:<\/p>\n Diese Zugangsdaten d\u00fcrfen nur auf dem Server verwendet werden. Sie d\u00fcrfen weder im Browser-JavaScript noch im \u00f6ffentlichen Code sichtbar sein.<\/p>\n RiskPayGo validiert die Domain, die Sie im Feld angeben. Wenn die Domain nicht mit einem Ihrer genehmigten Projekte \u00fcbereinstimmt, lehnt die API die Anfrage ab, selbst wenn das Token korrekt ist.<\/p>\n Daher ist es ratsam, vor Produktionsbeginn zu \u00fcberpr\u00fcfen, ob die genaue URL Ihres Shops oder Ihrer Anwendung im Panel registriert ist.<\/p>\n Um eine Zahlung auszul\u00f6sen, m\u00fcssen Sie einen Antrag stellen. In dieser Anfrage m\u00fcssen Sie die wichtigsten Informationen zur Bestellung angeben: den Betrag, die W\u00e4hrung, Ihre internen Referenzen, die Daten des K\u00e4ufers sowie die URLs f\u00fcr R\u00fccksendung und Benachrichtigung.<\/p>\n Eine typische Anfrage enth\u00e4lt Felder wie beispielsweise Nachfolgend finden Sie ein vollst\u00e4ndiges Beispiel f\u00fcr den Nachrichtentext, den Sie senden k\u00f6nnen:<\/p>\n Das Feld Bei erfolgreicher Anfrage sendet RiskPayGo eine Antwort mit der internen Zahlungsreferenz und der Checkout-URL. Mithilfe dieser Referenz k\u00f6nnen Sie die Zahlung Ihrer Bestellung zuordnen und diese anschlie\u00dfend verfolgen.<\/p>\n Die erwartete Antwort hat folgende Form:<\/p>\n Sobald Sie erhalten Die Zahlung wird \u00fcber einen von RiskPayGo bereitgestellten Checkout abgewickelt. Ihr System sollte die Bestellung nicht allein deshalb als bezahlt betrachten, weil Sie die Checkout-URL erhalten haben oder der Nutzer zur Website zur\u00fcckgekehrt ist.<\/p>\n Es wird empfohlen, die Referenz zu speichern. Der Wenn sich der Zahlungsstatus \u00e4ndert, sendet RiskPayGo eine Anfrage. Sie m\u00fcssen diese Signatur mit Ihrem Die zu \u00fcberpr\u00fcfende Kopfzeile ist diese:<\/p>\n Die RiskPayGo-Benachrichtigung kann Informationen wie H\u00e4ndler, Bestellnummer, Zahlungsreferenz, Status und Transaktions-ID enthalten. Ein Beispiel w\u00e4re folgendes:<\/p>\n Wichtig ist hierbei, dass Sie die Signatur validieren und dann den Wert verwenden. Bei der Integration m\u00fcssen vier Hauptzust\u00e4nde ber\u00fccksichtigt werden.<\/p>\n Generell wird empfohlen, den Webhook als prim\u00e4re Datenquelle zu verwenden und eine Bestellung erst dann als bezahlt zu betrachten, wenn Sie den entsprechenden Eingang erhalten. Wenn die API mit einem Autorisierungsfehler antwortet, sollten Sie als Erstes \u00fcberpr\u00fcfen, ob der gesendete Wert korrekt ist. Wenn das Problem in der Dom\u00e4ne liegt, \u00fcberpr\u00fcfen Sie den gesendeten Wert. Falls die API den Betrag ablehnt, stellen Sie sicher, dass Falls Ihr System die Benachrichtigung nicht validieren kann, \u00fcberpr\u00fcfen Sie, ob Sie die Wenn Sie das offizielle WooCommerce-Plugin verwenden, sind dieselben Integrationsdetails weiterhin erforderlich. Sie m\u00fcssen die Basis-URL, den H\u00e4ndler, das Token und das Webhook-Geheimnis konfigurieren.<\/p>\n Folgende Hauptwerte sind einzugeben:<\/p>\n Die Webhook-URL in WordPress hat \u00fcblicherweise dieses Format:<\/p>\n Vor Produktionsbeginn ist es ratsam, zu \u00fcberpr\u00fcfen, ob die Domain genehmigt ist und ob Ihre Mit dieser Struktur verf\u00fcgen Sie bereits \u00fcber eine solide Grundlage, um RiskPayGo in Ihre eigene Website, eine individuelle Anwendung oder einen WooCommerce-Shop zu integrieren.<\/p>","protected":false},"excerpt":{"rendered":" Esta documentaci\u00f3n explica c\u00f3mo integrar RiskPayGo en tu web o aplicaci\u00f3n para crear pagos, redirigir al comprador al checkout y […]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"default","adv-header-id-meta":"","stick-header-meta":"default","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"set","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"class_list":["post-502","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/riskpaygo.com\/de\/wp-json\/wp\/v2\/pages\/502","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/riskpaygo.com\/de\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/riskpaygo.com\/de\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/riskpaygo.com\/de\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/riskpaygo.com\/de\/wp-json\/wp\/v2\/comments?post=502"}],"version-history":[{"count":0,"href":"https:\/\/riskpaygo.com\/de\/wp-json\/wp\/v2\/pages\/502\/revisions"}],"wp:attachment":[{"href":"https:\/\/riskpaygo.com\/de\/wp-json\/wp\/v2\/media?parent=502"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}H\u00e4ndler-ID<\/code>, Du API-Token<\/code>, Du Webhook-Geheimnis<\/code> und die Basis-URL der API.<\/p>\nhttps:\/\/riskpaygo.com\/portal\/api\/plugin<\/code><\/pre>\nAuthentifizierung<\/h2>\n
Genehmigung<\/code> und die H\u00e4ndlerkennung im Header X-RPG-H\u00e4ndler<\/code>.<\/p>\nAccept: application\/json\nContent-Type: application\/json\nAuthorization: Bearer TU_API_TOKEN\nX-RPG-Merchant: TU_MERCHANT_ID<\/code><\/pre>\nGenehmigte Domain<\/h2>\n
Website-URL<\/code>Das bedeutet, dass g\u00fcltige Zugangsdaten nicht ausreichen: Die Domain, von der aus Sie die Zahlung erstellen, muss auch in Ihrem Konto registriert und genehmigt sein.<\/p>\nEine Zahlung erstellen<\/h2>\n
POST<\/code> zum Endpunkt f\u00fcr die Zahlungserstellung.<\/p>\nPOST https:\/\/riskpaygo.com\/portal\/api\/plugin\/payments\/create<\/code><\/pre>\nH\u00e4ndler-Bestell-ID<\/code>, Bestellnummer<\/code>, Bestellschl\u00fcssel<\/code>, Menge<\/code>, W\u00e4hrung<\/code>, Kunde<\/code>, Website<\/code>, notify_url<\/code>, R\u00fccksprung-URL<\/code> Und cancel_url<\/code>.<\/p>\n{\n \"merchant_order_id\": \"PED-1001\",\n \"order_id\": 1001,\n \"order_key\": \"pedido_1001_key\",\n \"amount\": \"149.99\",\n \"currency\": \"USD\",\n \"customer\": {\n \"email\": \"cliente@ejemplo.com\",\n \"first_name\": \"Nombre\",\n \"last_name\": \"Apellido\",\n \"phone\": \"+34123456789\",\n \"country\": \"ES\",\n \"date_of_birth\": \"1990-05-20\"\n },\n \"site\": {\n \"url\": \"https:\/\/tu-dominio.com\/\",\n \"name\": \"Mi tienda\",\n \"platform\": \"custom\",\n \"plugin\": \"integracion-propia\"\n },\n \"notify_url\": \"https:\/\/tu-dominio.com\/api\/riskpaygo\/webhook\",\n \"return_url\": \"https:\/\/tu-dominio.com\/pago\/completado\",\n \"cancel_url\": \"https:\/\/tu-dominio.com\/pago\/cancelado\"\n}<\/code><\/pre>\nMenge<\/code> Es muss gr\u00f6\u00dfer als null sein. Die W\u00e4hrung wird gesendet. W\u00e4hrung<\/code>. In Kunde<\/code> Es empfiehlt sich, zumindest die E-Mail-Adresse des K\u00e4ufers mitzusenden. Website-URL<\/code> Sie m\u00fcssen die genehmigte Domain einreichen. notify_url<\/code> Sie geben an, wohin Sie die Benachrichtigung \u00fcber den Zahlungsstatus erhalten m\u00f6chten.<\/p>\nAPI-Antwort<\/h2>\n
{\n \"success\": true,\n \"data\": {\n \"payment_ref\": \"RPG-20260313-ABC12345\",\n \"checkout_url\": \"https:\/\/riskpaygo.com\/portal\/checkout.php?ref=RPG-20260313-ABC12345\",\n \"fee_percent\": 20,\n \"plan_slug\": \"free\"\n }\n}<\/code><\/pre>\nCheckout-URL<\/code>Sie m\u00fcssen den K\u00e4ufer an diese Adresse weiterleiten, damit er die Zahlung abschlie\u00dfen kann.<\/p>\nWas ist beim Bezahlvorgang zu tun?<\/h2>\n
Zahlungsreferenz<\/code>Leiten Sie den K\u00e4ufer weiter und warten Sie auf die endg\u00fcltige Best\u00e4tigung per Webhook.<\/p>\nR\u00fccksprung-URL<\/code> Es dient dazu, den Nutzer nach der Zahlung auf Ihre Website zur\u00fcckzuf\u00fchren, der endg\u00fcltige Status sollte jedoch auf der Benachrichtigung basieren, die Sie erhalten. notify_url<\/code>.<\/p>\nBest\u00e4tigungs-Webhook<\/h2>\n
POST<\/code> zur angegebenen URL notify_url<\/code>Diese Benachrichtigung enth\u00e4lt oben eine Signatur. X-RPG-Signatur<\/code>.<\/p>\nWebhook-Geheimnis<\/code>Die Validierung muss am exakten Originaltext der Anfrage erfolgen, nicht an einem neu serialisierten JSON-Dokument.<\/p>\nX-RPG-Signature:<\/code><\/pre>\n{\n \"merchant_id\": \"TU_MERCHANT_ID\",\n \"order_id\": 1001,\n \"order_key\": \"pedido_1001_key\",\n \"payment_ref\": \"RPG-20260313-ABC12345\",\n \"transaction_id\": \"RPG-20260313-ABC12345\",\n \"status\": \"paid\",\n \"provider_status\": \"success\",\n \"provider_event\": \"payment_succeeded\",\n \"source\": \"payera_webhook\"\n}<\/code><\/pre>\nStatus<\/code> Um die Bestellung in Ihrem System zu aktualisieren.<\/p>\nZahlungsstatus<\/h2>\n
ausstehend<\/code> Es bedeutet, dass die Zahlung eingeleitet, aber noch nicht best\u00e4tigt wurde.<\/p>\nbezahlt<\/code> Dies bedeutet, dass die Zahlung erfolgreich best\u00e4tigt wurde. Diesen Status sollten Sie normalerweise verwenden, um die Bestellung als bezahlt zu markieren.<\/p>\nfehlgeschlagen<\/code> weist darauf hin, dass die Zahlung fehlgeschlagen oder abgelehnt wurde.<\/p>\nabgesagt<\/code> weist darauf hin, dass die Zahlung storniert wurde oder abgelaufen ist.<\/p>\nStatus = bezahlt<\/code>.<\/p>\nH\u00e4ufige Fehler<\/h2>\n
Nicht autorisierter H\u00e4ndler<\/h3>\n
Genehmigung<\/code> korrekt sein und dass der H\u00e4ndler eingesandt hat X-RPG-H\u00e4ndler<\/code> Sie m\u00fcssen dieses Token abgleichen. Au\u00dferdem m\u00fcssen Sie best\u00e4tigen, dass das Konto genehmigt und aktiv ist.<\/p>\nDomain nicht genehmigt<\/h3>\n
Website-URL<\/code> und \u00fcberpr\u00fcfen Sie, ob die Domain als genehmigtes Projekt im RiskPayGo-Panel existiert.<\/p>\nUng\u00fcltiger Betrag<\/h3>\n
Menge<\/code> Es wurde korrekt gesendet und hat einen Wert gr\u00f6\u00dfer als Null.<\/p>\nUng\u00fcltige Webhook-Signatur<\/h3>\n
Webhook-Geheimnis<\/code> korrekt ist und dass die Signaturberechnung auf dem exakten Originaltext der Anfrage durchgef\u00fchrt wird.<\/p>\nVerwendung mit WooCommerce<\/h2>\n
API Base URL: https:\/\/riskpaygo.com\/portal\/api\/plugin\nMerchant ID: TU_MERCHANT_ID\nAPI Token: TU_API_TOKEN\nWebhook Secret: TU_WEBHOOK_SECRET<\/code><\/pre>\nhttps:\/\/tu-dominio.com\/wp-json\/riskpaygo\/v1\/webhook<\/code><\/pre>\nAbschlie\u00dfende Empfehlungen<\/h2>\n
notify_url<\/code> Es antwortet korrekt \u00fcber HTTPS, was Sie speichern. Zahlungsreferenz<\/code> in Ihrem System und dass Sie Bestellungen erst dann als bezahlt markieren, wenn die endg\u00fcltige Best\u00e4tigung per Webhook eingeht.<\/p>\n