Skip to content

Logo

StreamPayments

Card payment processing for one-time and recurring payments.

Set up Account H2H merchant account

Step 1: Create Merchant Account

To create an account, contact your StreamPayments manager directly. Submit the required documents to verify your account and gain access.

Step 2: Get required credentials

Credentials that have to be issued:

  • API key
  • Terminal key
  • API URL → optional? if you need to specify base url for payments
  • Currency
  • Test Mode

Connect Merchant Account

Step 1. Connect H2H account at the StreamPayments Dashboard

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

Connect

Enter credentials:

  • API key
  • Terminal key
  • API URL
  • Currency

Success

You have connected StreamPayments H2H merchant account!

API examples:

Minimum data set to create a payment invoices for payment_card_eur_hpp service

SALE

POST /api/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"payment_card_eur_hpp",
      "currency":"EUR",
      "amount":1,
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"55041b5b-adfd-4073-a92b-fd8b495a4cc1",
        "email":"johnsmith@gmail.com"
      },
      "test_mode":true,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "reference_id":"86e68af6-6b95-4cc0-be16-e4df8044604c",
      "service_fields":[
      ]
    }
  }
}

Maximum data set to create a payment invoices for payment_card_eur_hpp service

SALE

POST /api/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"payment_card_eur_hpp",
      "currency":"EUR",
      "amount":1,
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"bc75bc54-5023-4f98-8c0d-ec5ed7e8f380",
        "name":"John Smith",
        "email":"johnsmith@gmail.com",
        "phone":"+3806771234567",
        "address":{
          "full_address":"Shevchenko 123",
          "country":"BG",
          "region":"Sofia",
          "city":"Sofia",
          "street":"Shevchenko st",
          "post_code":"1000"
        }
      },
      "test_mode":true,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "reference_id":"08f5e97c-1170-4bda-9625-3bde3c6dcd20",
      "service_fields":[
      ]
    }
  }
}

Recurring payments

For recurring payments, save the card token after the initial customer-initiated transaction and use it for subsequent merchant-initiated payments.

SALE

POST /api/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"payment_card_eur_hpp",
      "currency":"EUR",
      "amount":1,
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize": true
        }
      },
      "customer":{
        "reference_id":"bc75bc54-5023-4f98-8c0d-ec5ed7e8f380",
        "email":"johnsmith@gmail.com"
      },
      "test_mode":true,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "reference_id":"03d2e2da-7288-4d72-9fa7-9d0d356ac7d3",
      "service_fields":[
      ]
    }
  }
}

Question

"Still looking for help connecting your StreamPayments account?" Please contact our support team!