| Field name | Format | Length | Description |
|---|---|---|---|
| amount | Numeric | 1-12 | Order total amount in float format with decimal point (thousand separator not allowed). Ex: 1234.56 |
| curr | String | 3 | Order currency: 3-character currency code (RON, EUR, ...) |
| invoice_id | String | 1-45 | Merchant order ID |
| order_desc | String | 1-127 | Order description |
| merch_id | String | 8-50 | Merchant ID assigned by EuPlatesc.ro |
| timestamp | YYYYMMDDHHmmSS | 14 | Current timestamp in GMT: 20260702232920 |
| nonce | String | 16-64 | Merchant nonce. Must be filled with unpredictable random bytes in hexadecimal format |
| fp_hash | String | 1-256 | Merchant MAC in hexadecimal form |
| Field name | Format | Length | Description |
|---|---|---|---|
| fname | String | 1-255 | Client first name |
| lname | String | 1-255 | Client last name |
| company | String | 1-255 | Company data |
| add | String | 1-255 | Client street |
| city | String | 1-255 | Client city |
| state | String | 1-255 | Client state |
| zip | String | 1-25 | Client postal code |
| country | String | 1-55 | Client country |
| phone | String | 1-255 | Client phone number |
| String | 1-65 | Client email |
| Field name | Format | Length | Description |
|---|---|---|---|
| sfname | String | 1-255 | Client first name |
| slname | String | 1-255 | Client last name |
| scompany | String | 1-255 | Company data |
| sadd | String | 1-255 | Client street |
| scity | String | 1-255 | Client city |
| sstate | String | 1-255 | Client state |
| szip | String | 1-25 | Client postal code |
| scountry | String | 1-55 | Client country |
| sphone | String | 1-255 | Client phone number |
| semail | String | 1-65 | Client email |
| Field name | Format | Length | Description |
|---|---|---|---|
| Attention! It is not included in fp_hash, you should provide your own validation mechanism for sensible data | |||
| ExtraData | String | 0-10240 | Additional information sent by the mechant to the gateway. This data is echo back to the merchant in the reply request. |
| ExtraData[silenturl] | URL | 1-255 | Callback URL (server to server POST request) |
| ExtraData[silenturlsec] | URL | 1-255 | Callback URL SecStatus (server to server POST request) |
| ExtraData[successurl] | URL | 1-255 | URL to redirect client to in case of successfull transaction |
| ExtraData[failedurl] | URL | 1-255 | URL to redirect client to in case of failed transaction |
| ExtraData[ep_target] | String | 4 | "self" for the case of using iframe |
| ExtraData[ep_method] | String | 8 | "post","get","getclean" (keeping the original query params) for succes/fail redirect |
| ExtraData[backtosite] | URL | 1-255 | URL to redirect client to when clicking back to site button or after 60s on result page |
| ExtraData[backtosite_method] | String | 1-4 | "post" or "get" for the back to site button |
| ExtraData[expireurl] | String | 1-255 | If a timer is set on the payment page you can change the url that the client will be redirected to when the timer reach 0 |
| ExtraData[rate] | String | 0-10 | Installments number, format: [bank_code]-[installments_nr] |
| ExtraData[filtru_rate] | String | 0-300 | Installments number, format: [bank_code1]-[i_nr1]-..-[i_nrN],[bank_code2]-[i_nr1]-..-[i_nr2] ex: apb-3-4,btrl-5-6 |
| ExtraData[ep_channel] | String | 0-100 | Filter the available payment channels. Any combinations of the values CC, OP, C2P, GPAY, APAY, TBI, paypo concatenated with comma "," |
| generate_epid | String | 1 | If specified and set to 1, instead of redirecting the client will return a JSON containing the URL of the payment page |
| valability | YYYYMMDDHHmmSS | 14 | Payment link available until the specified timestamp (Romania timezone) Need to be added in the fp_hash after the nonce param |
| validate_cc | String | 1 | "If specified and set to 1, this will allow card validation with an amount of 0. |
| c2p_id | String | 1-50 | Unique ID of the client used for C2P wallet, blank values disable the wallet. Need to be added in the fp_hash after the nonce param (and after valability) |
| c2p_cid | Numeric | 1-12 | Unique ID of the enroled card used for C2P wallet. Need to be added in the fp_hash after the c2p_id param. |
| lang | String | 2 | Preselect the language of the payment page. Possible values: ro,en,fr,de,it,es,hu. If not sent the language will be chosen based on the client IP |
| Field name | Format | Length | Description |
|---|---|---|---|
| amount | Numeric | 1-12 | Echo from the request |
| curr | String | 3 | Echo from the request |
| invoice_id | String | 1-45 | Echo from the request |
| ep_id | String | 40 | Gateway unique id for each transaction |
| merch_id | String | 8-50 | Echo from the request |
| action | Numeric | 1 | If 0 – transaction approved else transaction failed |
| message | String | 6 | Response code text message |
| approval | String | 6 | Client bank’s approval code. Can be empty if not provided by gateway |
| timestamp | YYYYMMDD HHmmSS | 14 | Merchant transaction timestamp in GMT: 20260702232920 |
| nonce | String | 16-64 | Merchant nonce. Must be filled with unpredictable random bytes in hexadecimal format |
| fp_hash | String | 1-256 | Merchant MAC in hexadecimal form |
| Field name | Format | Length | Description |
|---|---|---|---|
| sec_status | Numeric | 1 | Additional security info Click for more |
| rrn | Numeric | 12 | Code generated by bank on customer's bank statement |
| mcard | Numeric | 4 | Last 4 digits of the used card |
| card_exp | Numeric | 4 | Expiration dat of the used card, format: YYmm |
| discount_amount | Numeric | 0-12 | Applied discount |
| payment_channel | String | 0-12 | CARD, GPay, ApplePay, C2P, OP, SMS, TBI |
| card_type | String | 0-16 | Visa, Mastercard, Maestro |
| bin | Numeric | 6 | First 6 digits of the used card |
| rate | String | 16 | Installments number, Format: X rate BANK, ex: 6 rate BTRL |
| card_holder | String | 1-64 | Name on the used card |
| String | 1-65 | Email of the customer | |
| rtype | String | 1-8 | Transaction type: Normal, Base, Recurent |
| cce | String | 64 | Unique id of the PAN |
| Field name | Format | Length | Description |
|---|---|---|---|
| recurent_freq | Numeric | 2 | Value in days max 255, included in fp_hash after nonce |
| recurent_exp | Numeric | 8 | YYYYmmdd, included in fp_hash after recurent_freq |
| recurent | String | 1-8 | "Base" - initial transaction "Recurent" - subsecquent transactions "Recurent2CIT" - 3Dsecure transaction not included in fp_hash |
| Card number | Card expire date | Card CVC | Card Name | Result message |
|---|---|---|---|---|
| 4111111111111111 | 28/01 | 123 | Test | Approved |
| 4444333322221111 | 28/01 | 123 | Test | Not sufficient funds |
| 4000020000000000 | 28/01 | 123 | Test | Transaction declined |
| 4400000000000008 | 28/01 | 123 | Test | Expired card |
| 4607000000000009 | 28/01 | 123 | Test | Invalid response |
| 4000640000000005 | 28/01 | 123 | Test | Approved |
| 5454545454545454 | 28/01 | 123 | Test | Authentication failed |
| 5555555555554444 | 28/01 | 123 | Test | Approved |
| 2222400010000008 | 28/01 | 123 | Test | Transaction declined |
| 2222400030000004 | 28/01 | 123 | Test | Expired card |
| 5100060000000002 | 28/01 | 123 | Test | Invalid response |
| 5500000000000004 | 28/01 | 123 | Test | Approved |
| 4989882771777727 | 28/01 | 123 | Test | Approved |
| 5500000000000012 | 28/01 | 123 | Test | Issuer unavailable |
| 5500000000000020 | 28/01 | 123 | Test | System malfunction |
| 5186001700008785 | 28/01 | 123 | Test | Approved |
| 5186001700009726 | 28/01 | 123 | Test | Approved |
| 5120350100064537 | 28/01 | 123 | Test | Approved |
| 5120350100064545 | 28/01 | 123 | Test | Approved |
| 2223001870064586 | 28/01 | 123 | Test | Approved |
| 5204731620064595 | 28/01 | 123 | Test | Approved |
| 4622943123103732 | 28/01 | 123 | Test | Approved |
| 4622943123103740 | 28/01 | 123 | Test | Approved |
| Field name | Format | Length | Description |
|---|---|---|---|
| method | String | fixed | Value: check_status |
| mid | String | 13 | MerchantID: 4484xxxxxxxxx |
| epid | String | 40 | The EPID of the transaction |
| invoice_id | String | 1-45 | Merchant order ID (if used, the epid should not be sent, also return max. 40 transactions if more have the same id) |
| timestamp | YYYYMMDD HHmmSS | 14 | Current timestamp in GMT: 20260702232920 |
| nonce | String | 16-64 | Merchant nonce. Must be filled with unpredictable random bytes in hexadecimal format |
| fp_hash | String | 1-256 | Merchant MAC in hexadecimal form |
| Code | Description |
|---|---|
| 1 | DB error |
| 2 | Invalid MID |
| 3 | Minimum nonce length is 16 |
| 4 | fp_hash must be at least 32 characters long |
| 5 | Timestamp difference is greater than 5 minutes |
| 6 | epid must be 40 characters long |
| 7 | Invalid invoice_id |
| 8 | DB query error |
| 9 | DB query error |
| 10 | No transaction found |
| 11 | Invalid key |
| 12 | Invalid key |
| Field name | Format | Length | Description |
|---|---|---|---|
| method | String | fixed | Value: capture / reversal |
| ukey | String | 1-8 | User key: xxxxx |
| epid | String | 40 | The EPID of the transaction |
| timestamp | YYYYMMDD HHmmSS | 14 | Current timestamp in GMT: 20260702232920 |
| nonce | String | 16-64 | Merchant nonce. Must be filled with unpredictable random bytes in hexadecimal format |
| fp_hash | String | 1-256 | Merchant MAC in hexadecimal form, the key used is not the merchant KEY but UAPI (see user settings) |
| Code | Description |
|---|---|
| 1 | DB error |
| 2 | Invalid ukey |
| 3 | DB query error |
| 4 | No rights |
| 5 | Timestamp difference is greater than 5 minutes |
| 6, 7 | Nu ai drepturi pentru aceasta actiune |
| 8 | Action failed, transaction already captured |
| 9 | Action failed, transaction is not approved |
| 10 | Action failed, transaction is pending |
| 11 | Action failed, transaction is not verified |
| 12 | Action failed, transaction is returned/refunded |
| 13 | Action failed, transaction expired, check manually |
| 14 | Invalid fp_hash |
| 15 | Invalid ukey |
| 16 | Action failed, transaction is an enrollment |
| Code | Description |
|---|---|
| 1 | DB error |
| 2 | Invalid ukey |
| 3 | DB query error |
| 4 | No rights |
| 5 | Timestamp difference is greater than 5 minutes |
| 6 | Nu ai drepturi pentru aceasta actiune |
| 7 | Nu ai drepturi pentru aceasta actiune |
| 8 | Action failed, transaction is captured, use refund |
| 9 | Action failed, transaction is pending |
| 10 | Action failed, transaction is already returned/refunded |
| 11 | Action failed, transaction is older than 6 months |
| 12 | Invalid fp_hash |
| 13 | Invalid ukey |
| 16 | Action failed, transaction is an enrollment |
| Field name | Format | Length | Description |
|---|---|---|---|
| method | String | fixed | Value: partial_capture |
| ukey | String | 1-8 | User key: xxxxx |
| amount | Numeric | 1-12 | Capture amount in float format with decimal point (thousand separator not allowed). Ex: 1234.56 | epid | String | 40 | The EPID of the transaction |
| timestamp | YYYYMMDD HHmmSS | 14 | Current timestamp in GMT: 20260702232920 |
| nonce | String | 16-64 | Merchant nonce. Must be filled with unpredictable random bytes in hexadecimal format |
| fp_hash | String | 1-256 | Merchant MAC in hexadecimal form, the key used is not the merchant KEY but UAPI (see user settings) |
| Code | Description |
|---|---|
| 1 | DB error |
| 2 | Invalid ukey |
| 3 | DB query error |
| 4 | No rights |
| 5 | Timestamp difference is greater than 5 minutes |
| 6 | Amount need to be with 2 decimals using dot |
| 7 | Nu ai drepturi pentru aceasta actiune |
| 8 | Amount can't be greater than transaction amount |
| 9 | Use capture if the amount is the total transaction amount |
| 10 | Nu ai drepturi pentru aceasta actiune |
| 11 | Action failed, transaction already captured |
| 12 | Invalid transaction type |
| 13 | Action failed, transaction is not approved |
| 14 | Action failed, transaction is pending |
| 15 | Installments can not be partial captured |
| 16 | Action failed, transaction is not verified |
| 17 | Action failed, transaction is returned/refunded |
| 18 | Action failed, transaction expired, check manually |
| Field name | Format | Length | Description |
|---|---|---|---|
| method | String | fixed | Value: refund |
| ukey | String | 1-8 | User key: xxxxx |
| amount | Numeric | 1-12 | Refunded amount in float format with decimal point (thousand separator not allowed). Ex: 1234.56 |
| reason | String | 5-55 | Short description of the reason of the refund |
| epid | String | 40 | The EPID of the transaction |
| timestamp | YYYYMMDD HHmmSS | 14 | Current timestamp in GMT: 20260702232920 |
| nonce | String | 16-64 | Merchant nonce. Must be filled with unpredictable random bytes in hexadecimal format |
| fp_hash | String | 1-256 | Merchant MAC in hexadecimal form, the key used is not the merchant KEY but UAPI (see user settings) |
| Code | Description |
|---|---|
| 1 | DB error |
| 2 | Invalid ukey |
| 3 | DB query error |
| 4 | No rights |
| 5 | Timestamp difference is greater than 5 minutes |
| 6 | You do not have permission for this action |
| 7 | You do not have permission for this action |
| 8 | Action failed, transaction is not approved |
| 9 | Reason length must be 5–55 characters |
| 10 | Invalid amount, format it with 2 decimals |
| 11 | Amount to be refunded needs to be smaller than transaction total |
| 12 | Action failed, transaction is pending |
| 13 | Action failed, transaction is not captured, use reversal |
| 14 | Action failed, transaction is already returned/refunded |
| 15 | Action failed, transaction is pending a refund |
| 16 | Action failed, transaction is older than 6 months |
| 17 | Action failed, transaction is marked as chargeback, contact an EuPlatesc operator |
| 18 | Invalid fp_hash |
| 19 | ukey not found |
| Field name | Format | Length | Description |
|---|---|---|---|
| method | String | fixed | Value: cancel_recurring |
| ukey | String | 1-8 | User key: xxxxx |
| epid | String | 40 | The baseEPID of the transaction or any EPID of the folowing transactions |
| reason | String | 0-55 | Short description of the reason |
| timestamp | YYYYMMDD HHmmSS | 14 | Current timestamp in GMT: 20260702232920 |
| nonce | String | 16-64 | Merchant nonce. Must be filled with unpredictable random bytes in hexadecimal format |
| fp_hash | String | 1-256 | Merchant MAC in hexadecimal form, the key used is not the merchant KEY but UAPI (see user settings) |
| Code | Description |
|---|---|
| 1 | DB error |
| 2 | Invalid ukey |
| 3 | DB query error |
| 4 | DB error 2 |
| 5 | Invalid fp_hash |
| 6 | Invalid ukey |
| Field name | Format | Length | Description |
|---|---|---|---|
| method | String | fixed | Value: update_iid |
| ukey | String | 1-8 | User key: xxxxx |
| epid | String | 40 | The EPID of the transaction |
| invoice_id | String | 1-27 | The updated invoice_id of the transaction |
| nonce | String | 16-64 | Merchant nonce. Must be filled with unpredictable random bytes in hexadecimal format |
| fp_hash | String | 1-256 | Merchant MAC in hexadecimal form, the key used is not the merchant KEY but UAPI (see user settings) |
| Code | Description |
|---|---|
| 1 | DB error |
| 2 | Invalid ukey |
| 3 | Invalid invoice_id length |
| 4 | Invalid invoice_id characters |
| 5 | DB query error |
| 6 | Timestamp difference is greater than 5 minutes |
| 7 | No rights for this transaction (transaction not found) |
| 8 | No rights for this merchant |
| 9 | Invoice ID cannot be updated, transaction is failed |
| 10 | Invoice ID cannot be updated, transaction is already fulfilled |
| 11 | DB error 2 |
| 12 | Invalid fp_hash |
| Field name | Format | Length | Description |
|---|---|---|---|
| method | String | fixed | Value: invoices |
| ukey | String | 1-8 | User key: xxxxx |
| mid | String | 13 | MerchantID: 4484xxxxxxxxx |
| from | String | 10 | Date: YYYY-mm-dd (if from and to are sent empty will search in last 3 months) |
| to | String | 10 | Date: YYYY-mm-dd |
| nonce | String | 16-64 | Merchant nonce. Must be filled with unpredictable random bytes in hexadecimal format |
| fp_hash | String | 1-256 | Merchant MAC in hexadecimal form, the key used is not the merchant KEY but UAPI (see user settings) |
| Code | Description |
|---|---|
| 1 | DB error |
| 2 | Invalid ukey |
| 3 | DB query error |
| 4 | No rights |
| 5 | Timestamp difference is greater than 5 minutes |
| 6 | Invalid parameter: from |
| 7 | Invalid parameter: to |
| 8 | Date interval is greater than 1 year |
| 9 | No rights for this merchant |
| 10 | Invalid fp_hash |
| Field name | Format | Length | Description |
|---|---|---|---|
| method | String | fixed | Value: invoice |
| ukey | String | 1-8 | User key: xxxxx |
| invoice | String | 11 | FPSxxxxxxxx invoice_number |
| nonce | String | 16-64 | Merchant nonce. Must be filled with unpredictable random bytes in hexadecimal format |
| fp_hash | String | 1-256 | Merchant MAC in hexadecimal form, the key used is not the merchant KEY but UAPI (see user settings) |
| Code | Description |
|---|---|
| 1 | DB error |
| 2 | Invalid ukey |
| 3 | DB query error |
| 4 | No rights |
| 5 | Timestamp difference is greater than 5 minutes |
| 6 | Partial rights for invoice (access to some MIDs only) |
| 7 | No rights for this invoice |
| 8 | Invoice fetch error |
| 9 | Invalid fp_hash |
| Field name | Format | Length | Description |
|---|---|---|---|
| method | String | fixed | Value: captured_total |
| ukey | String | 1-8 | User key: xxxxx |
| mids | String | 11 | MerchantIDs (separated by comma ",") |
| from | String | 10 | Date: YYYY-mm-dd (if from and to are sent empty will search in last 1 month) |
| to | String | 10 | Date: YYYY-mm-dd |
| nonce | String | 16-64 | Merchant nonce. Must be filled with unpredictable random bytes in hexadecimal format |
| fp_hash | String | 1-256 | Merchant MAC in hexadecimal form, the key used is not the merchant KEY but UAPI (see user settings) |
| Code | Description |
|---|---|
| 1 | DB error |
| 2 | Invalid ukey |
| 3 | DB query error |
| 5 | Timestamp difference is greater than 5 minutes |
| 7 | Nu ai drepturi pentru aceasta actiune |
| 14 | Invalid fp_hash |
| 15 | Invalid ukey |
| Field name | Format | Length | Description |
|---|---|---|---|
| method | String | fixed | Value: cardart |
| ukey | String | 1-8 | User key: xxxxx |
| ep_id | String | 40 | EPID of the Base transaction |
| timestamp | YYYYMMDD HHmmSS | 14 | Current timestamp in GMT: 20260702232920 |
| nonce | String | 16-64 | Merchant nonce. Must be filled with unpredictable random bytes in hexadecimal format |
| fp_hash | String | 1-256 | Merchant MAC in hexadecimal form, the key used is not the merchant KEY but UAPI (see user settings) |
| Code | Description |
|---|---|
| 1 | DB error |
| 2 | Invalid ukey |
| 3 | DB query error |
| 4 | Timestamp difference is greater than 5 minutes |
| 5 | DB query error |
| 6 | Nu ai drepturi pentru aceasta actiune |
| 8 | Cardart not found |
| 10 | invalid fp_hash |
| Field name | Format | Length | Description |
|---|---|---|---|
| method | String | fixed | Value: c2p_cards |
| mid | String | 11 | MerchantID |
| c2p_id | String | 1-50 | Unique ID of the client |
| timestamp | YYYYMMDD HHmmSS | 14 | Current timestamp in GMT: 20260702232920 |
| nonce | String | 16-64 | Merchant nonce. Must be filled with unpredictable random bytes in hexadecimal format |
| fp_hash | String | 1-256 | Merchant MAC in hexadecimal form |
| Code | Description |
|---|---|
| 1 | DB error |
| 3 | DB query error |
| 4 | Timestamp difference is greater than 5 minutes |
| 5 | DB query error |
| 6 | Nu ai drepturi pentru aceasta actiune |
| 6b | Nu ai drepturi pentru aceasta actiune |
| 7 | c2p_id can't be empty |
| 10 | invalid fp_hash |
| 11 | invalid fp_hash |
| 12 | invalid fp_hash |
| Field name | Format | Length | Description |
|---|---|---|---|
| method | String | fixed | Value: c2p_delete |
| mid | String | 11 | MerchantID |
| c2p_id | String | 1-25 | Unique ID of the client |
| c2p_cid | String | 1-10 | Unique ID of the saved card |
| timestamp | YYYYMMDD HHmmSS | 14 | Current timestamp in GMT: 20260702232920 |
| nonce | String | 16-64 | Merchant nonce. Must be filled with unpredictable random bytes in hexadecimal format |
| fp_hash | String | 1-256 | Merchant MAC in hexadecimal form |
| Code | Description |
|---|---|
| 1 | DB error |
| 3 | DB query error |
| 4 | Timestamp difference is greater than 5 minutes |
| 5 | DB query error |
| 6 | Nu ai drepturi pentru aceasta actiune |
| 7 | c2p_id can't be empty |
| 8 | c2p_cid can't be empty |
| 10 | invalid fp_hash |
| 11 | invalid fp_hash |
| 12 | invalid fp_hash |
| 14 | c2p_cid not found |
| Field name | Format | Length | Description |
|---|---|---|---|
| method | String | fixed | Value: check_mid |
| mid | String | 11 | MerchantID |
| timestamp | YYYYMMDD HHmmSS | 14 | Current timestamp in GMT: 20260702232920 |
| nonce | String | 16-64 | Merchant nonce. Must be filled with unpredictable random bytes in hexadecimal format |
| fp_hash | String | 1-256 | Merchant MAC in hexadecimal form |
| Code | Description |
|---|---|
| 1 | DB error |
| 2 | Invalid MID |
| 3 | Minimum nonce length is 16 |
| 4 | fp_hash must be 32 characters long |
| 5 | Timestamp difference is greater than 5 minutes |
| 6 | DB query error |
| 7 | Invalid key |
| 8 | Invalid key |

