Magnetiq Bank¶

Website: magnetiqbank.com

Set up Account H2H merchant account¶

Step 1: Create Merchant Account¶

To create an account send connection request at the magnetiqbank.com/en/contacts-and-details/ or contact manager directly. Submit the required documents to verify your account and gain access.

Step 2: Get required credentials¶

Credentials that have to be issued:

• magnetiqbank__merchant_interface_code → Merchant’s interface code
• magnetiqbank__private_key → Private key
• magnetiqbank__provider_public_key → Provider Public key
• magnetiqbank__merchant_public_key_index → Merchant public key Index
• magnetiqbank__test_mode → Test mode
• magnetiqbank__currency → choose currency (You can set these parameters according to available currencies and features for your Magnetiq Bank wallets and services, but it's necessary to check details of the connection with your Corefy account manager.)

Connect Merchant Account¶

Step 1. Connect H2H account at the Corefy Dashboard¶

Press Connect at Magnetiq Bank Provider Overview page in 'New connection' section and choose H2H Merchant account option to open Connection form.

Enter credentials:

• Merchant’s interface code
• Private key
• Provider Public key
• Merchant public key Index
• Test mode → true/false

API examples:¶

Minimum data set to create a payment invoices for payment_card_eur_hpp service¶

this request will be successful if the customer list is filled¶

SALE

POST /api/commerce/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"payment_card_eur_hpp",
      "commerce_account":"Hello World",
      "currency":"EUR",
      "amount":51.3,
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"7a94dd41-4d21-4c6d-b98d-eced7e2f7ab7"
      },
      "test_mode":true,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "reference_id":"b51921f4-1232-474f-825a-10a75fadad62",
      "service_fields":[
      ]
    }
  }
}

Maximum data set to create a payment invoices for payment_card_eur_hpp service¶

SALE

POST /api/commerce/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"payment_card_eur_hpp",
      "commerce_account":"Hello World",
      "currency":"EUR",
      "amount":51.3,
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"7a94dd41-4d21-4c6d-b98d-eced7e2f7ab7",
        "name":"John Doe",
        "email":"[email protected]"
      },
      "test_mode":true,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "reference_id":"b51921f4-1232-474f-825a-10a75fadad62",
      "service_fields":[
      ]
    }
  }
}

Provider Options¶

• Custom finalization logic
  • when the value = TRUE allows you to consider the status 6 (deposited) the final, automatically translating it into the status of FINAL[PROCESSED] without the need to wait for the final status from clearing
• Set additional data
  • If the value = true, then the option in the absence of the final status checks the presence of ARN and, if not, it delayed the finalization of the transaction by 15:00 the next day after clearing, using additional logic.
• Use API v3
  • using API version V3