O plată prin SMS Online se inițiază printr-un request de tip POST către:

https://secure.mobilpay.ro

Acest request va conține întotdeauna doi parametri esențiali:

🔑 Parametrii obligatorii

1️⃣ data

Conține datele criptate necesare procesării plății.

• Este generat pe baza unui XML.
• XML-ul este semnat și criptat folosind certificatul public X509 primit la crearea contului de comerciant.
• Include toate informațiile relevante pentru inițierea tranzacției.
  
   

2️⃣ env_key

Reprezintă „plicul” asociat cheii publice, generat în momentul criptării datelor.

Acest parametru permite sistemului mobilPay să decripteze conținutul transmis în data.

📦 Structura XML din parametrul data

Parametrul data conține un XML cu următoarea structură:

<?xml version="1.0" encoding="utf-8" ?>

<order type="sms" id="string64" timestamp="YYYYmmddHHiiss">

    <signature>XXXX-XXXX-XXXX-XXXX-XXXX</signature>

    <service>YYYYYY-YYYYYY-YYYYYY</service>

    <msisdn>07XXXXXXXX</msisdn>

    <url>

        <confirm>http://www.site_propriu.com/return</confirm>

        <return>http://www.site_propriu.com/confirm</return>

    </url>

    <params>

        <param>

            <name>param1Name</name>

            <value>param1Value</value>

        </param>

    </params>

</order>

🔎 Ce reprezintă principalele elemente

• type="sms" – specifică tipul plății
• id – identificator unic al comenzii
• timestamp – data și ora inițierii tranzacției
• signature – semnătura contului de comerciant
• service – identificatorul serviciului SMS
• msisdn – numărul de telefon al clientului
• confirm – URL-ul unde este transmis rezultatul tranzacției (server to server)
• return – URL-ul unde este redirecționat clientul
• params – parametri opționali personalizați
   

ℹ️ Important

• Request-ul trebuie transmis exclusiv prin POST.
• Datele XML trebuie criptate înainte de trimitere.
• Structura trebuie respectată conform documentației tehnice.
   

Aceasta este structura standard utilizată pentru inițierea unei plăți prin SMS Online în platforma NETOPIA.