FX/OG transactions

FX/OG transactions
  • FX/OG (Forex and Online Gambling) transaction is a type of transaction, where
  • Online Gambling functionality provides two features:
    1. Possibility to pay for chips or other value used in gambling
    2. Possibility to perform winning pay-outs to the card.
  • The message sequence in the Forex case is similar with Online Gambling, e.g., there are “purchase” transactions to put funds into the cardholder’s virtual account in the Forex trading platform, and there are transactions to withdraw the money from this virtual account.
FX/OG registration
  • Invoice registration for FX/OG payment requires same fields as described in Request for invoice generation/payment in a single request
  • Method: POST , URL: /invoice/process
  • Fields for signature calculation: <order_id><amount><currency><payment_method><X-Shop-Name><X-Nonce><ShopPassword>
  • Payment Methods: FD_FX, FD_OG, FD_FX_NO3D, FD_OG_NO3D
Response example:
 {
  "merchant_name_a": "",
  "merchant_name_b": "",
  "amount": 55,
  "required_connector_name": null,
  "due_date": null,
  "currency": "EUR",
  "order_id": "order-22222",
  "card_info": {
  "cardholder": "John Smith",
  "pan": "5599900000001237",
  "cvc": "123",
  "expiry": "0118",
  "mpi_callback_url": "https://merchantsite.example.com/mpi_callback"
  },
  "payment_method": "FD_FX",
  "customer": {},
  "products": []
 }
			    
FX/OG payouts
  • FX/OG payout uses the same refund approach as it was described earlier.
  • Method: POST , URL: /invoice/fx_og_refund/{invoice_ref}
Field Usage Description
amount M
Payout amount. Decimal point – “.” Two decimal digits available (example: 2000.00). (amount > 0)
There are amount restrictions both for Visa and MasterCard transactions:
Gambling Payment transactions (MasterCard) cannot exceed €50 000
Visa Original Credit Transaction amount cannot exceed $50 000 (€80 000 for Visa Europe transactions)
currency M Payout currency (alphabetic code, example EUR, 3 symbols based on ISO 4217)
csc Card security code (string). Mandatory for MC + gambling or special configuration in the administration system. Optional in the other cases
mpi_callback_url Return URL after 3D-Secure (MPI) authentication.
  • Fields for signature calculation:
    <invoice_ref><amount><currency><X-Shop-Name><X-Nonce><ShopPassword>
  • The request and response structure are the same as for regular money refund requests and responses.
Request example:
 {
  "amount": "125",
  "csc": "123",
  "mpi_callback_url": "https://merchantsite.example.com/mpi_callback",
  "currency": "EUR"
 }
			    
Response example:
 {
  "invoice": {
  "type": "InvoiceDto",
  "invoice_ref": "gbBzYQaUXEXDpLye1RoGN3Ak5",
  "amount": 55,
  "currency": "EUR",
  "created_date": "2017-07-14T13:23:48.860Z",
  "updated_date": "2017-07-14T13:29:25.613Z",
  "due_date": "2017-07-15T13:23:48.860Z",
  "shop_code": "TEST",
  "invoice_status": "SUCCEEDED",
  "payment_id": "20826681",
  "target_payment_id": null,
  "order_id": "order-22222",
  "error_code": null,
  "error_message": null,
  "payment_method": "FD_FX",
  "merchant_name_a": null,
  "merchant_name_b": null,
  "customer": {},
  "products": [],
  "details": {}
  },
  "payment_transaction": {
  "id": 247211,
  "amount": 125,
  "payment_id": "20826701",
  "target_payment_id": null,
  "currency": "EUR",
  "minor_amount": 12500,
  "created_date": "2017-07-14T13:29:25.559Z",
  "updated_date": "2017-07-14T13:29:25.613Z",
  "transaction_type": "REFUND",
  "status": "SUCCEEDED",
  "error_code": null,
  "error_message": null,
  "shop_code": "TEST",
  "invoice_ref": "gbBzYQaUXEXDpLye1RoGN3Ak5"
  },
  "view": "finished"
 }