Pi Pay¶

Welcome to Pi Pay. Experience the World of Infinite Possibilities.

Set up Account H2H merchant account¶

Step 1: Create Merchant Account¶

To create an account send connection request at the www.pipay.com/contact-us 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:

pi_pay__username → Username
pi_pay__password → Password
pi_pay__vendure_token → Vendure token
pi_pay__currency → choose currency (You can set these parameters according to available currencies and features for your Pi Pay 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 Pi Pay Provider Overview page in 'New connection' section and choose H2H Merchant account option to open Connection form.

Connect

Enter credentials:

Username
Password
Vendure token
Currency

Success

You have connected Pi Pay H2H merchant account!

API examples:¶

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

SALE
POST /api/commerce/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"payment_card_usd_hpp",
      "commerce_account":"hello_world",
      "currency":"USD",
      "amount":1,
      "reference_id":"8413694f-da4e-4223-b00b-09acc5094ce5",
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"e347b4c6-3f82-4c67-94f2-cf977eba97f8",
        "name":"Sergio Vitalletti"
      },
      "test_mode":false,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "service_fields":[
      ]
    }
  }
}

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

SALE
POST /api/commerce/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"payment_card_usd_hpp",
      "commerce_account":"hello_world",
      "currency":"USD",
      "amount":1,
      "reference_id":"b6cfd163-6f43-4a3a-84e1-72593ac9273f",
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"3b278d23-c930-472c-878b-07886ce15fde",
        "name":"Serge Kot",
        "email":"[email protected]",
        "phone":"442011114444",
        "date_of_birth":"1996-10-17",
        "individual_tax_id":"213123123",
        "address":{
          "full_address":"Kiev, Kiev",
          "country":"UA",
          "region":"Kiev",
          "city":"Kiev",
          "street":"Kiev, Kiev",
          "post_code":"123123sdsd"
        }
      },
      "test_mode":false,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "service_fields":[
      ]
    }
  }
}

Constants¶

Сonstants

If some parameters are not sent in the transaction creation request, they will take the values from the set constants.

Here is a list of constants with their corresponding parameters:

STOCK_KEEPING_UNIT → constants [stock_keeping_unit]
QUANTITY → constants [quantity]

Question

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