Questa documentazione spiega come integrare RiskPayGo nel tuo sito web o nella tua applicazione per creare pagamenti, reindirizzare l'acquirente alla pagina di pagamento e ricevere la conferma finale dello stato tramite webhook.<\/p>\n
L'integrazione deve essere effettuata dal backend. Si sconsiglia di esporre credenziali o logiche sensibili sul frontend.<\/p>\n
Prima di iniziare, \u00e8 necessario disporre di un conto commerciante approvato e attivo con RiskPayGo. \u00c8 inoltre necessario disporre delle credenziali di integrazione e assicurarsi che il dominio da cui si intende ricevere i pagamenti sia approvato all'interno del proprio account.<\/p>\n
I dati di cui avrai bisogno sono i tuoi L'URL di base \u00e8 il seguente:<\/p>\n Tutte le richieste API devono essere autenticate. Per farlo, \u00e8 necessario includere il token privato nell'intestazione. Le intestazioni necessarie sono le seguenti:<\/p>\n Queste credenziali devono essere utilizzate esclusivamente sul server. Non devono essere visibili nel codice JavaScript del browser o nel codice pubblico.<\/p>\n RiskPayGo convalida il dominio che invii nel campo Se il dominio non corrisponde a uno dei progetti approvati, l'API rifiuter\u00e0 la richiesta anche se il token \u00e8 corretto.<\/p>\n Pertanto, prima di passare alla fase di produzione, \u00e8 consigliabile verificare che l'URL corretto del proprio negozio o applicazione sia registrato nel pannello di controllo.<\/p>\n Per avviare un pagamento, \u00e8 necessario inviare una richiesta. Nella richiesta \u00e8 necessario inviare le informazioni principali dell'ordine: l'importo, la valuta, i riferimenti interni, i dati dell'acquirente e gli URL per il reso e la notifica.<\/p>\n Una richiesta tipica includer\u00e0 campi come Di seguito \u00e8 riportato un esempio completo del corpo del messaggio che \u00e8 possibile inviare:<\/p>\n Il campo Se la richiesta ha esito positivo, RiskPayGo restituisce una risposta con il riferimento interno del pagamento e l'URL di pagamento. Questo riferimento consente di collegare il pagamento al proprio ordine e di tracciarlo in seguito.<\/p>\n La risposta attesa assume questa forma:<\/p>\n Non appena ricevi Il pagamento viene elaborato tramite una pagina di pagamento gestita da RiskPayGo. Il tuo sistema non deve considerare l'ordine pagato semplicemente perch\u00e9 hai ottenuto l'URL della pagina di pagamento o perch\u00e9 l'utente \u00e8 tornato sul sito web.<\/p>\n Si consiglia di salvare il riferimento. IL Quando lo stato del pagamento cambia, RiskPayGo invier\u00e0 una richiesta \u00c8 necessario convalidare quella firma utilizzando il tuo L'intestazione che devi controllare \u00e8 questa:<\/p>\n La notifica di RiskPayGo pu\u00f2 includere informazioni quali il commerciante, il riferimento dell'ordine, il riferimento del pagamento, lo stato e l'ID della transazione. Ecco un esempio:<\/p>\n La cosa importante qui \u00e8 che si convalida la firma e poi si utilizza il valore di Durante l'integrazione \u00e8 necessario considerare quattro stati principali.<\/p>\n La raccomandazione generale \u00e8 di utilizzare il webhook come fonte primaria di verit\u00e0 e considerare l'ordine pagato solo quando lo si riceve Se l'API risponde con un errore di autorizzazione, la prima cosa da controllare \u00e8 che il valore inviato in Se il problema \u00e8 nel dominio, controlla il valore inviato in Se l'API rifiuta l'importo, assicurati che Se il tuo sistema non riesce a convalidare la notifica, verifica di utilizzare il Se utilizzi il plugin ufficiale di WooCommerce, sono comunque necessari gli stessi dettagli di integrazione. Dovrai configurare l'URL di base, il commerciante, il token e il segreto del webhook.<\/p>\n I valori principali da inserire sono i seguenti:<\/p>\n L'URL del webhook in WordPress ha solitamente questo formato:<\/p>\n Prima di andare in produzione, \u00e8 consigliabile verificare che il dominio sia approvato, che il tuo Con questa struttura disponi gi\u00e0 di una solida base per integrare RiskPayGo nel tuo sito web, in un'applicazione personalizzata o in un negozio WooCommerce.<\/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\/it\/wp-json\/wp\/v2\/pages\/502","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/riskpaygo.com\/it\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/riskpaygo.com\/it\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/riskpaygo.com\/it\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/riskpaygo.com\/it\/wp-json\/wp\/v2\/comments?post=502"}],"version-history":[{"count":0,"href":"https:\/\/riskpaygo.com\/it\/wp-json\/wp\/v2\/pages\/502\/revisions"}],"wp:attachment":[{"href":"https:\/\/riskpaygo.com\/it\/wp-json\/wp\/v2\/media?parent=502"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}ID Commerciante<\/code>, Voi Token API<\/code>, Voi Segreto del webhook<\/code> e l'URL di base dell'API.<\/p>\nhttps:\/\/riskpaygo.com\/portal\/api\/plugin<\/code><\/pre>\nAutenticazione<\/h2>\n
Autorizzazione<\/code> e l'identificativo del commerciante nell'intestazione X-RPG-Mercante<\/code>.<\/p>\nAccept: application\/json\nContent-Type: application\/json\nAuthorization: Bearer TU_API_TOKEN\nX-RPG-Merchant: TU_MERCHANT_ID<\/code><\/pre>\nDominio approvato<\/h2>\n
URL del sito<\/code>Ci\u00f2 significa che possedere credenziali valide non \u00e8 sufficiente: il dominio da cui si effettua il pagamento deve essere registrato e approvato nel proprio account.<\/p>\nCrea un pagamento<\/h2>\n
INVIARE<\/code> all'endpoint di creazione del pagamento.<\/p>\nPOST https:\/\/riskpaygo.com\/portal\/api\/plugin\/payments\/create<\/code><\/pre>\nID_ordine_mercante<\/code>, ID ordine<\/code>, chiave_ordine<\/code>, quantit\u00e0<\/code>, valuta<\/code>, cliente<\/code>, sito<\/code>, URL di notifica<\/code>, URL di ritorno<\/code> E 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>\nquantit\u00e0<\/code> Deve essere maggiore di zero. La valuta viene inviata in valuta<\/code>. In cliente<\/code> \u00c8 consigliabile inviare almeno l'indirizzo email dell'acquirente. URL del sito<\/code> \u00c8 necessario inviare il dominio approvato. URL di notifica<\/code> \u00c8 necessario indicare dove si desidera ricevere la notifica sullo stato del pagamento.<\/p>\nRisposta API<\/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>\nURL di checkout<\/code>\u00c8 necessario reindirizzare l'acquirente a quell'indirizzo affinch\u00e9 possa completare il pagamento.<\/p>\nCosa fare riguardo al checkout<\/h2>\n
riferimento_pagamento<\/code>Reindirizzare l'acquirente e attendere la conferma finale tramite webhook.<\/p>\nURL di ritorno<\/code> Serve a riportare l'utente al tuo sito dopo il pagamento, ma lo stato finale dovrebbe essere basato sulla notifica che ricevi in URL di notifica<\/code>.<\/p>\nWebhook di conferma<\/h2>\n
INVIARE<\/code> all'URL indicato in URL di notifica<\/code>Tale notifica include una firma in alto. Firma X-RPG<\/code>.<\/p>\nSegreto del webhook<\/code>La convalida deve essere effettuata sul corpo originale esatto della richiesta, non su un JSON riserializzato.<\/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>\nstato<\/code> per aggiornare l'ordine nel tuo sistema.<\/p>\nStato dei pagamenti<\/h2>\n
in attesa di<\/code> Ci\u00f2 indica che il pagamento \u00e8 stato avviato ma non \u00e8 ancora stato confermato.<\/p>\npagato<\/code> Questo indica che il pagamento \u00e8 stato confermato con successo. Questo \u00e8 lo stato che normalmente dovresti utilizzare per contrassegnare l'ordine come pagato.<\/p>\nfallito<\/code> indica che il pagamento non \u00e8 andato a buon fine o \u00e8 stato rifiutato.<\/p>\nannullato<\/code> indica che il pagamento \u00e8 stato annullato o \u00e8 scaduto.<\/p>\nstato = pagato<\/code>.<\/p>\nErrori comuni<\/h2>\n
Commerciante non autorizzato<\/h3>\n
Autorizzazione<\/code> essere corretto e che il commerciante ha inviato X-RPG-Mercante<\/code> deve corrispondere a quel token. \u00c8 inoltre necessario confermare che l'account sia approvato e attivo.<\/p>\nDominio non approvato<\/h3>\n
URL del sito<\/code> e verificare che il dominio esista come progetto approvato all'interno del pannello RiskPayGo.<\/p>\nImporto non valido<\/h3>\n
quantit\u00e0<\/code> \u00c8 stato inviato correttamente e ha un valore maggiore di zero.<\/p>\nFirma del webhook non valida<\/h3>\n
Segreto del webhook<\/code> corretto e che il calcolo della firma venga effettuato sul corpo originale esatto della richiesta.<\/p>\nUtilizzabile con 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>\nRaccomandazioni finali<\/h2>\n
URL di notifica<\/code> Risponde correttamente tramite HTTPS, che viene salvato. riferimento_pagamento<\/code> nel tuo sistema e che contrassegni gli ordini come pagati solo quando arriva la conferma finale tramite webhook.<\/p>\n