SEPA Request to Pay (SRTP)

SEPA Request to Pay (SRTP) es un esquema de pago definido por el Consejo Europeo de Pagos (EPC) que utiliza mensajería en tiempo real para iniciar pagos. Un comercio envía una solicitud de pago al cliente, quien la aprueba a través de su banco. MONEI es compatible con SRTP, lo que permite a los comercios solicitar y recibir pagos basados en SEPA directamente a través de la API.

Características y ventajas

• Aprobación del pago con un solo clic: Los clientes reciben una solicitud de pago y la aprueban con un solo clic, sin necesidad de introducir manualmente el IBAN ni los datos bancarios.
• Disponibilidad 24/7: Las solicitudes de pago pueden crearse y enviarse en cualquier momento, de forma independiente al horario bancario.
• Flexibilidad en el momento del pago: Los clientes pueden aprobar las solicitudes de inmediato o en un momento posterior antes de que caduquen.
• Seguimiento del estado en tiempo real: Todos los estados de las transacciones SRTP (pendiente, aceptada, rechazada) son visibles en el MONEI Dashboard en tiempo real.
• Integración en el checkout: SRTP puede ofrecerse como método de pago en tu página de checkout para flujos de comercio electrónico.
• Control del flujo de caja: Los clientes deciden cuándo aprobar las solicitudes de pago entrantes, lo que les da flexibilidad sobre el momento del pago.
• Sin contracargos: SRTP utiliza SEPA Instant Credit Transfer. Una vez aprobados y ejecutados, los pagos son irrevocables.

Flujo de mensajería

El siguiente diagrama muestra el flujo de mensajes SRTP en un modelo de cuatro esquinas (pagador y beneficiario, cada uno con su propio proveedor de servicios SRTP), seguido de una explicación paso a paso:

1. Selección del método de pago: El pagador selecciona SEPA Request to Pay (SRTP) como método de pago en la página de pago (checkout) del comercio.
2. Inicio de la solicitud: El beneficiario (comercio) notifica a MONEI (el proveedor de servicios SRTP del beneficiario) sobre una nueva solicitud de pago, proporcionando todos los detalles necesarios. MONEI crea entonces un mensaje SRTP para esta solicitud.
3. Entrega al proveedor del pagador: MONEI, en nombre del beneficiario, envía el mensaje SRTP al proveedor de servicios SRTP del pagador (normalmente el banco del pagador o el servicio de pago).
4. Notificación al pagador: El proveedor de servicios del pagador notifica al pagador (p. ej., a través de una aplicación móvil o banca en línea) que hay una solicitud de pago pendiente de aprobación. El pagador puede revisar los detalles de la solicitud y elegir aceptarla o rechazarla.
5. Comunicación del estado: Una vez que el pagador acepta o rechaza la solicitud, el resultado (estado de aprobación o rechazo) se comunica a todas las partes. MONEI y el comercio reciben una actualización de estado que confirma si el SRTP fue aceptado (y el pago iniciado) o rechazado por el pagador. Esta actualización de estado puede producirse en tiempo real o mediante un mecanismo de callback.

Endpoints de la API

MONEI proporciona un conjunto de endpoints de API REST para integrar el esquema SRTP, que permite crear y gestionar mensajes de solicitud de pago. A continuación se indican los principales endpoints del flujo SRTP con sus detalles:

Crear un nuevo SRTP

Descripción: Este endpoint permite al proveedor de servicios SRTP del beneficiario (p. ej., MONEI en nombre del comercio) publicar una nueva solicitud de pago SEPA en el proveedor de servicios SRTP del pagador. En la práctica, crea una solicitud de pago que se entregará al pagador para su aprobación.

Endpoint: https://api.monei.com/v1/sepa-request-to-pay-requests

Instrucciones:

• Todos los parámetros de la solicitud deben cumplir con el reglamento SRTP y las Directrices de implementación SRTP oficiales.
• Los campos ReqdExctnDt (fecha/hora de ejecución solicitada) y XpryDt (fecha/hora de vencimiento) deben proporcionarse y deben ser fechas futuras (no fechas pasadas); de lo contrario, la solicitud será rechazada.
• Para cada nueva llamada de creación de SRTP, utiliza un resourceId único. Este ID actúa como clave de idempotencia para la solicitud; enviar un resourceId duplicado se tratará como la misma solicitud.

Ejemplo de solicitud JSON:

{
  "callbackUrl": "https://testing-srtp.com/005/callback",
  "Document": {
    "CdtrPmtActvtnReq": {
      "GrpHdr": {
        "MsgId": "Id20***3731",
        "CreDtTm": "2024-04-30T15:59:30.000Z",
        "NbOfTxs": "1",
        "InitgPty": {
          "Nm": "SRTPTestEPCXX",
          "Id": {
            "OrgId": {
              "AnyBIC": "AAAAZZ12"
            }
          }
        }
      },
      "PmtInf": [
        {
          "PmtInfId": "Id20***3317",
          "PmtMtd": "TRF",
          "ReqdAdvcTp": {
            "CdtAdvc": {
              "Cd": "ADND"
            },
            "DbtAdvc": {
              "Cd": "ADND"
            }
          },
          "ReqdExctnDt": {
            "DtTm": "2024-06-26T15:59:14.000Z"
          },
          "XpryDt": {
            "DtTm": "2024-06-29T18:00:00.000Z"
          },
          "Dbtr": {
            "Nm": "Max140Text_EPC259-22_V3.0_DS02",
            "PstlAdr": {
              "Ctry": "FR",
              "AdrLine": ["01 Rue de Paris"]
            },
            "Id": {
              "OrgId": {
                "AnyBIC": "AAAAZZ12"
              }
            }
          },
          "DbtrAcct": {
            "Id": {
              "IBAN": "ES9131906664658225183334"
            },
            "Nm": "Nm"
          },
          "DbtrAgt": {
            "FinInstnId": {
              "BICFI": "MMMMES69"
            }
          },
          "CdtTrfTx": [
            {
              "PmtId": {
                "InstrId": "InstrId",
                "EndToEndId": "Id20***5809"
              },
              "PmtTpInf": {
                "SvcLvl": {
                  "Cd": "SRTP"
                },
                "LclInstrm": {
                  "Cd": "CTP"
                },
                "CtgyPurp": {
                  "Cd": " "
                }
              },
              "PmtCond": {
                "AmtModAllwd": false,
                "EarlyPmtAllwd": true,
                "GrntedPmtReqd": false
              },
              "Amt": {
                "InstdAmt": 2001
              },
              "ChrgBr": "SLEV",
              "CdtrAgt": {
                "FinInstnId": {
                  "BICFI": "AAAAZZ11234"
                }
              },
              "Cdtr": {
                "Nm": "Max140Text_EPC259-22_V3.0_DS02",
                "PstlAdr": {
                  "Ctry": "FR",
                  "AdrLine": ["01 Rue de Paris"]
                },
                "Id": {
                  "OrgId": {
                    "AnyBIC": "AAAAZZ12"
                  }
                }
              },
              "CdtrAcct": {
                "Id": {
                  "IBAN": "ES9131906664658225183334"
                }
              },
              "InstrForCdtrAgt": [
                {
                  "InstrInf": "ATS007 Positive functional confirmation requested"
                }
              ],
              "Purp": {
                "Cd": "ADCS"
              },
              "RltdRmtInf": {
                "RmtId": "RmtId",
                "RmtLctnDtls": [
                  {
                    "Mtd": "URID",
                    "ElctrncAdr": "test@monei.com"
                  }
                ]
              },
              "RmtInf": {
                "Ustrd": ["Ustrd"]
              }
            }
          ]
        }
      ]
    }
  },
  "resourceId": "8410-8600-1312-3709"
}

Ejemplo de respuesta JSON:

{
  "resourceId": "8410-8600-1312-3709",
  "Document": {
    "CdtrPmtActvtnReqStsRpt": {
      "GrpHdr": {
        "MsgId": "2f5424439ad4a3590203e9afbdc185762fe",
        "CreDtTm": "2024-06-25T09:36:45.764Z",
        "InitgPty": {
          "Id": {
            "OrgId": {
              "AnyBIC": "MMMMES69"
            }
          }
        }
      },
      "OrgnlGrpInfAndSts": {
        "OrgnlMsgId": "Id20***3731",
        "OrgnlMsgNmId": "pain.013.001.10",
        "OrgnlCreDtTm": "2024-04-30T15:59:30.000Z"
      },
      "OrgnlPmtInfAndSts": [
        {
          "OrgnlPmtInfId": "Id20***3317",
          "TxInfAndSts": {
            "StsId": "a6128f3fc0692ae3b3834c397555893baf1",
            "OrgnlInstrId": "InstrId",
            "OrgnlEndToEndId": "Id20***5809",
            "TxSts": "ACTC",
            "StsRsnInf": {
              "Orgtr": {
                "Id": {
                  "OrgId": {
                    "AnyBIC": "MMMMES69"
                  }
                }
              },
              "Rsn": {
                "Cd": "EDTR"
              }
            },
            "OrgnlTxRef": {
              "Amt": {
                "InstdAmt": 2001
              },
              "ReqdExctnDt": {
                "DtTm": "2024-06-26T15:59:14.000Z"
              },
              "XpryDt": {
                "DtTm": "2024-06-29T18:00:00.000Z"
              },
              "PmtTpInf": {
                "SvcLvl": {
                  "Cd": "SRTP"
                },
                "LclInstrm": {
                  "Cd": "CTP"
                }
              },
              "DbtrAgt": {
                "FinInstnId": {
                  "BICFI": "MMMMES69"
                }
              },
              "CdtrAgt": {
                "FinInstnId": {
                  "BICFI": "AAAAZZ11234"
                }
              },
              "Cdtr": {
                "Nm": "Max140Text_EPC259-22_V3.0_DS02",
                "Id": {
                  "OrgId": {
                    "AnyBIC": "AAAAZZ12"
                  }
                }
              },
              "CdtrAcct": {
                "Id": {
                  "IBAN": "ES9131906664658225183334"
                }
              },
              "RmtInf": {
                "Ustrd": "Ustrd"
              }
            }
          }
        }
      ]
    }
  }
}

Actualización de estado

Descripción: Este endpoint lo utiliza el proveedor de servicios SRTP del beneficiario para consultar el estado de una solicitud de pago creada anteriormente. Solicita al proveedor de servicios SRTP del pagador una actualización sobre si el pagador ha aceptado, rechazado o todavía no ha actuado sobre la solicitud de pago.

Endpoint: https://api.monei.com/v1/sepa-request-to-pay-requests/{{resourceId}}/status-update

Instrucciones:

• Todos los parámetros deben seguir el reglamento SRTP y las Directrices de implementación.
• El parámetro de ruta {resourceId} en la URL del endpoint debe ser el mismo resourceId que se devolvió cuando se creó el SRTP. (En otras palabras, estás solicitando el estado de esa solicitud de pago específica.) Por ejemplo, si el resourceId original es 8410-8600-1312-3709, el endpoint de estado sería:
  .../sepa-request-to-pay-requests/8410-8600-1312-3709/status-update
• Si la información de estado está disponible, el servidor de la API responderá inmediatamente con el estado actual. En caso contrario (p. ej., si el pagador aún no ha respondido), el servidor devolverá un acuse de recibo pendiente y enviará la actualización de estado de forma asíncrona a la URL de callback proporcionada.
• Esta llamada no crea ningún recurso nuevo, por lo que usar el mismo resourceId para múltiples consultas de estado simplemente recuperará el mismo estado (es idempotente en ese sentido).

Ejemplo de solicitud JSON:

{
  "resourceId": "5427-9966-1810-4084",
  "callbackUrl": "https://testing-srtp.com/005/callback",
  "Document": {
    "FIToFIPmtStsReq": {
      "GrpHdr": {
        "MsgId": "Id20***6359",
        "CreDtTm": "2024-04-19T15:40:14.000Z",
        "InstgAgt": {
          "FinInstnId": {
            "BICFI": "AAAAZZ11",
            "LEI": "00000032411889200037",
            "Nm": "SRTPTestEPCXX",
            "Othr": {
              "Id": "Id20***6848",
              "SchmeNm": {
                "Cd": "aaaa",
                "Prtry": "Max35Text"
              },
              "Issr": " Issr"
            }
          }
        }
      },
      "TxInf": [
        {
          "StsReqId": "StsReqId",
          "OrgnlGrpInf": {
            "OrgnlMsgId": "Id20***8079",
            "OrgnlMsgNmId": "pain.013.001.10",
            "OrgnlCreDtTm": "2024-04-13T15:02:05.000Z"
          },
          "OrgnlInstrId": "InstrId",
          "OrgnlEndToEndId": "Id2024041915393549256381",
          "OrgnlTxId": "OrgnlTxId",
          "OrgnlTxRef": {
            "Amt": {
              "InstdAmt": 2013
            },
            "ReqdExctnDt": {
              "DtTm": "2024-05-02T15:02:04.000Z"
            },
            "PmtTpInf": {
              "SvcLvl": {
                "Cd": "SRTP"
              },
              "LclInstrm": {
                "Cd": "CTP"
              }
            },
            "RmtInf": {
              "Ustrd": ["Ustrd"]
            },
            "DbtrAgt": {
              "FinInstnId": {
                "BICFI": "MMMMES69"
              }
            },
            "CdtrAgt": {
              "FinInstnId": {
                "BICFI": "AAAAZZ11234"
              }
            },
            "Cdtr": {
              "Pty": {
                "Nm": "Max140Text_EPC259-22_V3.0_DS02",
                "Id": {
                  "OrgId": {
                    "AnyBIC": "AAAAZZ12"
                  }
                }
              }
            },
            "CdtrAcct": {
              "Id": {
                "IBAN": "FR7630003035710005023922834"
              }
            }
          }
        }
      ]
    }
  }
}

Ejemplo de respuesta JSON:

{
  "resourceId": "5427-9966-1810-4084",
  "Document": {
    "CdtrPmtActvtnReqStsRpt": {
      "GrpHdr": {
        "MsgId": "a5f786c715aba67ab04e34ad62286c72fa1",
        "CreDtTm": "2024-06-25T09:39:17.015Z",
        "InitgPty": {
          "Id": {
            "OrgId": {
              "AnyBIC": "MMMMES69"
            }
          }
        }
      },
      "OrgnlGrpInfAndSts": {
        "OrgnlMsgId": "Id20***6359",
        "OrgnlMsgNmId": "pacs.028.001.03",
        "OrgnlCreDtTm": "2024-04-30T15:59:30.000Z"
      },
      "OrgnlPmtInfAndSts": [
        {
          "OrgnlPmtInfId": "Id20***3317",
          "TxInfAndSts": [
            {
              "StsId": "5f79f32400bf21b7053a91def757f7fc418",
              "OrgnlInstrId": "InstrId",
              "OrgnlEndToEndId": "Id2024041915393549256381",
              "StsRsnInf": {
                "Orgtr": {
                  "Id": {
                    "OrgId": {
                      "AnyBIC": "MMMMES69"
                    }
                  }
                },
                "Rsn": {
                  "Cd": "AEXR"
                }
              },
              "OrgnlTxRef": {
                "Amt": {
                  "InstdAmt": 2013
                },
                "ReqdExctnDt": {
                  "DtTm": "2024-05-02T15:02:04.000Z"
                },
                "XpryDt": {
                  "DtTm": "2024-06-29T18:00:00.000Z"
                },
                "PmtTpInf": {
                  "SvcLvl": {
                    "Cd": "SRTP"
                  },
                  "LclInstrm": {
                    "Cd": "CTP"
                  }
                },
                "DbtrAgt": {
                  "FinInstnId": {
                    "BICFI": "MMMMES69"
                  }
                },
                "CdtrAgt": {
                  "FinInstnId": {
                    "BICFI": "AAAAZZ11234"
                  }
                },
                "Cdtr": {
                  "Nm": "Max140Text_EPC259-22_V3.0_DS02",
                  "Id": {
                    "OrgId": {
                      "AnyBIC": "AAAAZZ12"
                    }
                  }
                },
                "CdtrAcct": {
                  "Id": {
                    "IBAN": "FR7630003035710005023922834"
                  }
                },
                "RmtInf": {
                  "Ustrd": "Ustrd"
                }
              }
            }
          ]
        }
      ]
    }
  }
}

Solicitud de cancelación

Descripción: Este endpoint lo utiliza el proveedor de servicios SRTP del beneficiario para solicitar la cancelación de una solicitud de pago enviada anteriormente. Básicamente, envía un mensaje de cancelación al proveedor de servicios SRTP del pagador indicando que el beneficiario (comercio) desea cancelar la solicitud de pago.

Endpoint: https://api.monei.com/v1/sepa-request-to-pay-requests/{{resourceId}}/cancellation-requests

Instrucciones:

• Todos los parámetros deben seguir el reglamento SRTP y las Directrices de implementación para mensajes de cancelación.
• El {resourceId} en la URL del endpoint es el resourceId del SRTP original (el mismo ID utilizado al crear la solicitud de pago). Esto identifica qué solicitud de pago se está cancelando. Por ejemplo:
  .../sepa-request-to-pay-requests/8410-8600-1312-3709/cancellation-requests
• En el cuerpo de la solicitud, proporciona un nuevo resourceId único. Este será el identificador de la propia solicitud de cancelación (a menudo denominado cancellationResourceId). Este ID debe ser diferente del resourceId del pago original, ya que se utilizará en el endpoint de estado de cancelación.
• Cuando sea posible, la API del pagador puede responder inmediatamente con el resultado de la cancelación. Si no está disponible un resultado inmediato, la API acusará recibo de la solicitud y enviará el resultado de la cancelación a través de la URL de callback.

Ejemplo de solicitud JSON:

{
  "callbackUrl": "https://testing-srtp.com/005/callback",
  "Document": {
    "CstmrPmtCxlReq": {
      "Assgnmt": {
        "Id": "Id20***7140",
        "Assgnr": {
          "Pty": {
            "Id": {
              "OrgId": {
                "AnyBIC": "AAAAZZ12"
              }
            }
          }
        },
        "Assgne": {
          "Pty": {
            "Id": {
              "OrgId": {
                "AnyBIC": "MMMMES69"
              }
            }
          }
        },
        "CreDtTm": "2024-04-23T15:58:37.000Z"
      },
      "Undrlyg": {
        "OrgnlPmtInfAndCxl": [
          {
            "PmtCxlId": "Id20***5990",
            "OrgnlPmtInfId": "Id20***9456",
            "OrgnlGrpInf": {
              "OrgnlMsgId": "Id20***8505",
              "OrgnlMsgNmId": "pain.013.001.10",
              "OrgnlCreDtTm": "2024-04-24T15:46:07.000Z"
            },
            "TxInf": [
              {
                "CxlId": "Id20***2849",
                "OrgnlInstrId": "InstrId",
                "OrgnlEndToEndId": "Id20***4837",
                "CxlRsnInf": {
                  "Orgtr": {
                    "Nm": "SRTPTestEPCXX",
                    "Id": {
                      "OrgId": {
                        "AnyBIC": "AAAAZZ12"
                      }
                    }
                  },
                  "Rsn": {
                    "Cd": "TECH"
                  },
                  "AddtlInf": ["ATS005/2024-05-08T15:46:06.000Z"]
                },
                "OrgnlTxRef": {
                  "Amt": {
                    "InstdAmt": 2018
                  },
                  "ReqdExctnDt": {
                    "DtTm": "2024-05-13T15:46:06.000Z"
                  },
                  "PmtTpInf": {
                    "SvcLvl": {
                      "Cd": "SRTP"
                    },
                    "LclInstrm": {
                      "Cd": "CTP"
                    }
                  },
                  "RmtInf": {
                    "Ustrd": "Ustrd"
                  },
                  "DbtrAgt": {
                    "FinInstnId": {
                      "BICFI": "MMMMES69"
                    }
                  },
                  "CdtrAgt": {
                    "FinInstnId": {
                      "BICFI": "AAAAZZ11234"
                    }
                  },
                  "Cdtr": {
                    "Pty": {
                      "Nm": "Max140Text_EPC259-22_V3.0_DS02",
                      "Id": {
                        "OrgId": {
                          "AnyBIC": "AAAAZZ12"
                        }
                      }
                    }
                  },
                  "CdtrAcct": {
                    "Id": {
                      "IBAN": "FR7630003035710005023922834"
                    }
                  }
                }
              }
            ]
          }
        ]
      }
    }
  },
  "resourceId": "8410-8600-1312-3592"
}

Ejemplo de respuesta JSON:

{
  "resourceId": "8410-8600-1312-3593",
  "SepaRequestToPayCancellationResponse": {
    "Document": {
      "RsltnOfInvstgtn": {
        "Assgnmt": {
          "Id": "Id20***7140",
          "Assgnr": {
            "Pty": {
              "Id": {
                "OrgId": {
                  "AnyBIC": "MMMMES69"
                }
              }
            }
          },
          "Assgne": {
            "Pty": {
              "Id": {
                "OrgId": {
                  "AnyBIC": "AAAAZZ12"
                }
              }
            }
          },
          "CreDtTm": "2024-04-23T15:58:37.000Z"
        },
        "Sts": {
          "Conf": "CNCL"
        },
        "CxlDtls": {
          "OrgnlPmtInfAndSts": [
            {
              "OrgnlPmtInfId": "Id20***9456",
              "TxInfAndSts": [
                {
                  "OrgnlInstrId": "InstrId",
                  "OrgnlEndToEndId": "Id20***4837"
                }
              ]
            }
          ],
          "TxInfAndSts": [
            {
              "CxlStsId": "f4c9c8dba13b1aa99f9aa9c6ebd9fe61b73",
              "OrgnlGrpInf": {
                "OrgnlMsgId": "Id20***8505",
                "OrgnlMsgNmId": "pain.013.001.10",
                "OrgnlCreDtTm": "2024-04-24T15:46:07.000Z"
              },
              "OrgnlInstrId": "InstrId",
              "OrgnlEndToEndId": "Id20***4837",
              "TxCxlSts": "ACCR",
              "CxlStsRsnInf": {
                "Orgtr": {
                  "Id": {
                    "OrgId": {
                      "LEI": "95980008YL8WG2MZQQ40"
                    }
                  }
                },
                "AddtlInf": ["ATS005/2024-05-13T15:46:06.000Z"]
              },
              "OrgnlTxRef": {
                "Amt": {
                  "InstdAmt": 2018
                },
                "ReqdExctnDt": {
                  "DtTm": "2024-05-13T15:46:06.000Z"
                },
                "PmtTpInf": {
                  "SvcLvl": {
                    "Cd": "SRTP"
                  },
                  "LclInstrm": {
                    "Cd": "CTP"
                  }
                },
                "DbtrAgt": {
                  "FinInstnId": {
                    "BICFI": "MMMMES69"
                  }
                },
                "CdtrAgt": {
                  "FinInstnId": {
                    "BICFI": "AAAAZZ11234"
                  }
                },
                "Cdtr": {
                  "Pty": {
                    "Nm": "Max140Text_EPC259-22_V3.0_DS02",
                    "Id": {
                      "OrgId": {
                        "AnyBIC": "AAAAZZ12"
                      }
                    }
                  }
                },
                "CdtrAcct": {
                  "Id": {
                    "IBAN": "FR7630003035710005023922834"
                  }
                },
                "RmtInf": {
                  "Ustrd": "Ustrd"
                }
              }
            }
          ]
        }
      }
    }
  }
}

Actualización de estado de la cancelación

Descripción: Este endpoint permite al proveedor de servicios SRTP del beneficiario solicitar una actualización de estado para una solicitud de cancelación realizada anteriormente. Es decir, tras iniciar la cancelación de un SRTP, el proveedor del beneficiario puede usar este endpoint para comprobar si dicha cancelación ha sido procesada/reconocida por la parte del pagador.

Endpoint: https://api.monei.com/v1/sepa-request-to-pay-requests/{{resourceId}}/cancellation-requests/{{cancellationResourceId}}/status-update

Instrucciones:

• Todos los parámetros deben seguir el reglamento SRTP y las Directrices de implementación.
• El {resourceId} en la URL hace referencia al resourceId del SRTP del pago original (el mismo utilizado en la creación y en la solicitud de cancelación). El {cancellationResourceId} corresponde al resourceId único que se utilizó en la solicitud de cancelación. Por ejemplo, si resourceId = 8410-8600-1312-3709 y el resourceId de la cancelación fue 8410-8600-1312-3593, entonces:
  .../requests/8410-8600-1312-3709/cancellation-requests/8410-8600-1312-3593/status-update
• Esta consulta de estado es idempotente: solicitar el estado de la misma cancelación más de una vez devolverá el mismo resultado (una vez que se conoce el resultado de la cancelación, no cambiará en consultas posteriores).
• Si el resultado de la cancelación ya está disponible, la API lo devolverá de inmediato. En caso contrario, se devuelve un acuse de recibo y el estado final se entregará más tarde a través de la URL de callback (tal como se proporcionó durante la solicitud de cancelación).

Ejemplo de solicitud JSON:

{
  "resourceId": "9813-7776-2938-9347",
  "Document": {
    "CstmrPmtCxlReq": {
      "Assgnmt": {
        "Id": "123456U",
        "Assgnr": {
          "Pty": {
            "Id": {
              "OrgId": {
                "AnyBIC": "AAAAZZ12"
              }
            }
          }
        },
        "Assgne": {
          "Pty": {
            "Id": {
              "OrgId": {
                "AnyBIC": "ZZZZAA12"
              }
            }
          }
        },
        "CreDtTm": "2024-01-16T13:33:53.000Z"
      },
      "Undrlyg": {
        "OrgnlPmtInfAndCxl": [
          {
            "PmtCxlId": "0***07",
            "OrgnlPmtInfId": "0***06",
            "OrgnlGrpInf": {
              "OrgnlMsgId": "202***1",
              "OrgnlMsgNmId": "SRTPTestEPC",
              "OrgnlCreDtTm": "2024-01-16T13:33:53.000Z"
            },
            "TxInf": [
              {
                "CxlId": "123456789A",
                "OrgnlInstrId": "InstrId",
                "OrgnlEndToEndId": "EndtoEnd",
                "CxlRsnInf": {
                  "Orgtr": {
                    "Id": {
                      "OrgId": {
                        "AnyBIC": "MMMMES69"
                      }
                    }
                  },
                  "Rsn": {
                    "Cd": "AC02"
                  }
                },
                "OrgnlTxRef": {
                  "Amt": {
                    "InstdAmt": 2108
                  },
                  "ReqdExctnDt": {
                    "DtTm": "2024-02-04T13:33:52.000Z"
                  },
                  "PmtTpInf": {
                    "SvcLvl": {
                      "Cd": "SRTP"
                    },
                    "LclInstrm": {
                      "Cd": "CTP"
                    }
                  },
                  "DbtrAgt": {
                    "FinInstnId": {
                      "BICFI": "PECOFIHH"
                    }
                  },
                  "CdtrAgt": {
                    "FinInstnId": {
                      "BICFI": "AAAAZZ11"
                    }
                  },
                  "Cdtr": {
                    "Pty": {
                      "Nm": "Max140Text_EPC259-22_V3.0_DS02",
                      "Id": {
                        "OrgId": {
                          "AnyBIC": "AAAAZZ12"
                        }
                      }
                    }
                  },
                  "CdtrAcct": {
                    "Id": {
                      "IBAN": "ES9131906664658225183334"
                    }
                  }
                }
              }
            ]
          }
        ]
      }
    }
  },
  "callbackUrl": "https://testing-srtp.com/005/callback"
}

Ejemplo de respuesta JSON:

{
  "resourceId": "9813-7776-2938-9347",
  "Document": {
    "RsltnOfInvstgtn": {
      "Assgnmt": {
        "Id": "6bd60078b1f08bef6f486a324225de4344b",
        "Assgnr": {
          "Pty": {
            "Id": {
              "OrgId": {
                "AnyBIC": "ZZZZAA12"
              }
            }
          }
        },
        "Assgne": {
          "Pty": {
            "Id": {
              "OrgId": {
                "AnyBIC": "AAAAZZ12"
              }
            }
          }
        },
        "CreDtTm": "2024-04-23T15:58:37.000Z"
      },
      "Sts": {
        "AssgnmtCxlConf": true
      },
      "CxlDtls": {
        "OrgnlPmtInfAndSts": [
          {
            "OrgnlPmtInfId": "Id20***9456",
            "TxInfAndSts": [
              {
                "OrgnlEndToEndId": "Id20***4837",
                "OrgnlInstrId": "InstrId"
              }
            ]
          }
        ],
        "TxInfAndSts": [
          {
            "CxlStsId": "a578f447abced8d534f42d29ee06fc7dd3e",
            "OrgnlGrpInf": {
              "OrgnlMsgId": "Id20***8505",
              "OrgnlMsgNmId": "camt.055.001.08",
              "OrgnlCreDtTm": "2024-04-23T15:58:37.000Z"
            },
            "OrgnlInstrId": "InstrId",
            "OrgnlEndToEndId": "Id20***4837",
            "CxlStsRsnInf": {
              "Orgtr": {
                "Id": {
                  "OrgId": {
                    "LEI": "95980008YL8WG2MZQQ40"
                  }
                }
              },
              "AddtlInf": ["ATS005/2024-05-13T15:46:06.000Z"],
              "Rsn": {
                "Cd": "AEXR"
              }
            },
            "OrgnlTxRef": {
              "Cdtr": {
                "Pty": {
                  "Nm": "Max140Text_EPC259-22_V3.0_DS02",
                  "Id": {
                    "OrgId": {
                      "AnyBIC": "AAAAZZ12"
                    }
                  }
                }
              },
              "CdtrAgt": {
                "FinInstnId": {
                  "BICFI": "AAAAZZ11234"
                }
              },
              "PmtTpInf": {
                "SvcLvl": {
                  "Cd": "SRTP"
                },
                "LclInstrm": {
                  "Cd": "CTP"
                }
              },
              "ReqdExctnDt": {
                "DtTm": "2024-05-13T15:46:06.000Z"
              },
              "CdtrAcct": {
                "Id": {
                  "IBAN": "FR7630003035710005023922834"
                }
              },
              "DbtrAgt": {
                "FinInstnId": {
                  "BICFI": "MMMMES69"
                }
              },
              "Amt": {
                "InstdAmt": 2018
              },
              "RmtInf": {
                "Ustrd": "Ustrd"
              }
            }
          }
        ]
      }
    }
  }
}

Adhesión e integración

La implementación del esquema SRTP de MONEI se ofrece a través de una API REST segura que gestiona la mensajería necesaria con los sistemas bancarios. Los endpoints descritos anteriormente permiten la creación, consulta de estado y cancelación de mensajes de solicitud de pago en pleno cumplimiento con el reglamento SRTP. Esta API garantiza la interoperabilidad con los bancos y proporciona a los socios de MONEI una integración fluida, abstrayendo gran parte de la complejidad del protocolo SRTP detrás de una sencilla API web.

En particular, MONEI ofrece un Servicio de integración SRTP que agiliza la adopción del esquema SRTP para los proveedores de servicios de pago. Este servicio incluye herramientas de prueba y un entorno sandbox controlado, que permite tanto pruebas automatizadas como manuales de los flujos de mensajes SRTP. Dado que MONEI gestiona la mensajería SRTP y el cumplimiento normativo, un banco o proveedor de servicios del pagador que utilice esta integración no necesita someterse por su cuenta a la certificación SRTP formal completa. MONEI asume la responsabilidad de cumplir con las especificaciones técnicas, lo que simplifica considerablemente el proceso de adhesión al esquema SRTP.

Si eres un proveedor de servicios SRTP del pagador interesado en la integración SRTP, puedes ponerte en contacto con MONEI para obtener documentación técnica detallada y credenciales de acceso. MONEI proporcionará toda la información y el soporte necesarios para conectarse a la API SRTP y comenzar a probar la integración. Con la orientación de MONEI, los proveedores de servicios pueden incorporar rápidamente SRTP a sus ofertas y empezar a aprovechar este nuevo esquema de solicitud de pago.