PSPark¶

Accept crypto payments from anyone anywhere.

Set up Account Provider account¶

Step 1: Create Provider account¶

To create an account send connection request at the pspark.io → Contact sales 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:

pspark__api_key → Api key
pspark--wallet_id → Wallet ID
pspark__public_key → Public Key
pspark__private_key → Private Key

Connect Provider Account¶

Step 1. Connect Provider account at the Corefy Dashboard¶

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

Connect

Enter credentials:

Api key
Wallet ID
Public Key
Private Key

Success

You have connected PSPark Provider account!

API examples:¶

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

if constants are filled

PAYMENT

POST /api/commerce/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"blik_pln_hpp",
      "commerce_account":"Hello_World",
      "currency":"PLN",
      "amount":20,
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":false
        }
      },
      "customer":{
        "reference_id":"dba3d2c4-1802-4796-9ade-d0b881d5f21c"
      },
      "test_mode":false,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "reference_id":"5fe0ca57-3b88-4ef6-be69-5e8a041df789",
      "service_fields":[
      ]
    }
  }
}

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

PAYMENT

POST /api/commerce/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"blik_pln_hpp",
      "commerce_account":"Hello_World",
      "currency":"PLN",
      "amount":20,
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":false
        }
      },
      "customer":{
        "reference_id":"0af1ea5f-3818-46b7-98c6-941778c4d635",
        "name":" John Doe",
        "email":"[email protected]",
        "phone":"380995522999",
        "date_of_birth":"2025-03-21",
        "individual_tax_id":" 800-772-1213",
        "address":{
          "full_address":"Street 123",
          "country":"IN",
          "region":"Mumbai",
          "city":"Mumbai",
          "street":"Street 123",
          "post_code":"12345"
        },
        "metadata":{
          "payment_purpose":"test",
          "client_agent":"Mozilla\/5.0 (Linux; Android 10; K) AppleWebKit\/537.36 (KHTML, like Gecko) Chrome\/114.0.0.0 Mobile Safari\/537.36",
          "ip":"127.0.0.1",
          "national_id":"32"
        }
      },
      "test_mode":false,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "reference_id":"2229fd73-666e-4542-a8b9-db26c499be80",
      "service_fields":[
      ]
    }
  }
}

Minimum data set to create a payout invoices for blik_pln service¶

PAYOUT

POST /api/commerce/payout-invoices HTTP/1.0
{
  "data":{
    "type":"payout-invoice",
    "attributes":{
      "service":"blik_pln",
      "commerce_account":"hello_world",
      "currency":"PLN",
      "amount":20,
      "test_mode":false,
      "reference_id":"561de38d-37fa-47f1-b6f4-09a621c1fd91",
      "fields":[
      ],
      "options":{
        "attempts_limit":0,
        "split_mode":false,
        "allow_partially":false,
        "auto_process":false
      }
    }
  }
}

Maximum data set to create a payout invoices for blik_pln service¶

PAYOUT

POST /api/commerce/payout-invoices HTTP/1.0
{
  "data":{
    "type":"payout-invoice",
    "attributes":{
      "service":"blik_pln",
      "commerce_account":"hello_world",
      "currency":"PLN",
      "amount":20,
      "customer":{
        "reference_id":"ORDER123",
        "name":"John Wick",
        "email":"[email protected]",
        "phone":"4456456456",
        "date_of_birth":"1998-03-03",
        "individual_tax_id":"9823456",
        "first_name":"John",
        "surname":"Wick",
        "patronymic":"Stevenson",
        "passport_number":"12345",
        "passport_series":"PC",
        "address":{
          "full_address":"United ",
          "country":"AD",
          "region":"London",
          "city":"London",
          "street":"Oxsford",
          "post_code":"Wqsd11"
        }
      },
      "test_mode":false,
      "reference_id":"79332a74-3a38-45dc-a6c7-67ac0255c06f",
      "fields":[
      ],
      "options":{
        "attempts_limit":0,
        "split_mode":false,
        "allow_partially":false,
        "auto_process":false
      }
    }
  }
}

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:

DESCRIPTION → constants [description]
FIRST_NAME → customer [first_name]
LAST_NAME → customer [last_name]
EMAIL → customer [email]
PHONE → customer [phone]
СUSTOMER_REFERENCE_ID → customer [customer_reference_id] ?? constants [customer_reference_id]
FULL_ADDRESS → customer [address] [full_address]
COUNTRY_CODE → customer [address] [country_code]
COUNTRY → customer [address] [country]
CITY → customer [address] [city]
POST_CODE → customer [address] [post_code]
REGION → customer [address] [region]
IP → constant [ip]
USER_AGENT → constants [user_agent]
BIRTH_DATE → customer [birth_date] ?? constants [birth_date]
PAYMENT_PURPOSE → customer [metadata] [payment_purpose] ?? constants [payment_purpose]
NATIONAL_ID → customer [national_id] ?? constants [national_id]

Question

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