Spayz¶

INTEGRATED SOFTWARE FOR THE BUSINESS SPACE. Stay ahead of the game in the payment technology market

Website: spayz.io

Set up Account Provider account¶

Step 1: Create Provider account¶

To create an account send connection request at the spayz.io/contact 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:

spayz__mid → Merchant ID
spayz__api_key → API key
spayz__callback_public_key → Callback Public Key

Connect Provider Account¶

Step 1. Connect Provider account at the Corefy Dashboard¶

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

Connect

Enter credentials:

Merchant ID
API key
Callback Public Key

Success

You have connected Spayz Provider account!

API examples:¶

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

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

PAYMENT

POST /api/commerce/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"bank_transfer_krw_hpp",
      "commerce_account":"Hello World",
      "currency":"KRW",
      "amount":10004,
      "reference_id":"726c5cd5-2145-4d31-9bc7-d15dc0681d69",
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"36ce2130-b8b8-49e7-86db-72c745472044"
      },
      "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 bank_transfer_krw_hpp service¶

PAYMENT

POST /api/commerce/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"bank_transfer_krw_hpp",
      "commerce_account":"Hello World",
      "currency":"KRW",
      "amount":10000,
      "reference_id":"91f56672-6764-4aae-9761-1da464336ad8",
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"36ce2130-b8b8-49e7-86db-72c745472044",
        "name":"John Doe",
        "email":"[email protected]",
        "metadata":{
          "ip":"3.65.180.235"
        }
      },
      "test_mode":false,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "service_fields":[
      ]
    }
  }
}

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

PAYOUT

POST /api/commerce/payout-invoices HTTP/1.0
{
  "data":{
    "type":"payout-invoice",
    "attributes":{
      "service":"bank_transfer_krw",
      "commerce_account":"Hello World",
      "currency":"KRW",
      "amount":10000,
      "metadata":{
        "ip":"127.0.0.1"
      },
      "test_mode":false,
      "reference_id":"a8361481-9f0e-4cb2-bdb4-a97d4e70e473",
      "fields":{
        "beneficiary_name":"John",
        "beneficiary_lastname":"Wick",
        "beneficiary_email":"[email protected]",
        "bank_code":"10099",
        "account_name":"John Wick",
        "account_number":"12345678901234567890"
      },
      "options":{
        "attempts_limit":0,
        "split_mode":false,
        "allow_partially":false,
        "auto_process":false
      }
    }
  }
}

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

PAYOUT

POST /api/commerce/payout-invoices HTTP/1.0
{
  "data":{
    "type":"payout-invoice",
    "attributes":{
      "service":"bank_transfer_krw",
      "commerce_account":"Hello World",
      "currency":"KRW",
      "amount":10000,
      "metadata":{
        "ip":"127.0.0.1"
      },
      "test_mode":false,
      "reference_id":"a8361481-9f0e-4cb2-bdb4-a97d4e70e473",
      "fields":{
        "beneficiary_name":"John",
        "beneficiary_lastname":"Wick",
        "beneficiary_email":"[email protected]",
        "beneficiary_phone":"38065432123",
        "bank_code":"10099",
        "account_name":"John Wick",
        "account_number":"12345678901234567890"
      },
      "options":{
        "attempts_limit":0,
        "split_mode":false,
        "allow_partially":false,
        "auto_process":false
      }
    }
  }
}

Question

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