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

https://secure.mobilpay.ro

Acest request 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 necesare inițierii tranzacției.

2️⃣ env_key

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

Acest parametru permite decriptarea informațiilor transmise î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="card" id="string64" timestamp="YYYYmmddHHiiss">

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

    <url>

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

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

    </url>

    <invoice currency="XXX" amount="LL.BB">

        <details></details>

        <contact_info>

            <billing type="company|person">

                <first_name>Prenume</first_name>

                <last_name>Nume</last_name>

                <country></country>

                <county></county>

                <city></city>

                <zip_code></zip_code>

                <address></address>

                <email></email>

                <mobile_phone></mobile_phone>

                <bank></bank>

                <iban></iban>

            </billing>

            <shipping type="company|person" sameasbilling="1">

                <first_name>Prenume</first_name>

                <last_name>Nume</last_name>

                <country></country>

                <county></county>

                <city></city>

                <zip_code></zip_code>

                <address></address>

                <email></email>

                <mobile_phone></mobile_phone>

                <bank></bank>

                <iban></iban>

            </shipping>

        </contact_info>

    </invoice>

    <params>

        <param>

            <name>param1Name</name>

            <value>param1Value</value>

        </param>

    </params>

</order>

🔎 Ce reprezintă principalele elemente

• type="card" – specifică tipul plății
• id – identificator unic al comenzii
• timestamp – data și ora inițierii tranzacției
• signature – semnătura contului de comerciant
• confirm – URL-ul pentru confirmarea server-to-server a plății
  return – URL-ul către care este redirecționat clientul
• invoice – informații despre sumă, monedă și detalii factură
• contact_info – datele de facturare și livrare
• params – parametri opționali personalizați
   

ℹ️ Important

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

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