Getting started Last update : 2022-02-06

You can easily receive payments from your site and access detailed reports of your payment. If you want, you can download your payment histories (Excel, PDF, CSV) and keep them yourself.

Adding a site

To add a site, the site you will add from this page.

Parameters:
  • Site Name: The name you will give to the site you will add.
  • Domain: The plain domain of your site. Ex: example.com
  • Callback URL: The url required to post the transaction to your site when you receive payment. Ex: example.com/callback.php
  • Redirect URL: The URL to which the successful paying user will be redirected. Ex: example.com/panel/

Token creation

When you enter the site parameters from this page and add, your unique token is created.

How to get tokens:

By entering this page, find the site you want to trade for and get its token.

Example my sites table:
# Site adı Domain Callback Yönlendirme Onaylama Token Secret Callback API key
# E-ticaret sitem e-ticaret.com e-ticaret.com/callback.php https://e-ticaret.com Manuel 53defe0c167159ac26a6cdda8230e633 48f4be928f1cb47a61d7b496e3a53225 912a26e6982924aba91e07a4a8545b78
# E-ticaret sitem 2 e-ticaret2.com e-ticaret2.com/callback.php https://e-ticaret.com Otomatik 826dac0eef8822c05a8a1b93dfb0b002 143597123cb8bdb204ffa3501389c386 3bb9cb82223860ee48d1c3aafcc76cfd

Installation

Here we will create a link to receive payment from the user using the necessary parameters.

Creating a payment link

The necessary parameters to create a payment link are given below.

Parameters:
  • API URL: https://payment.payofast.com/redirect.php
  • Method: POST
  • SaleID: Order number. For example: 123
  • Token: The token defined on your site.
  • Secret: The secret token defined on your site.
  • Amount: Payment amount.
  • Value: The ID of your paying user. For example: Kulanici@gmail.com
Sample code:

Live test

You can test the system by clicking the button below.

Pay

Payment processing and security

Here's how you can securely process incoming payments.

POST when payment is made

When your user pays you need a callback file to process the payment. The POST values sent to your Callback file as a result of payment are as follows.

Parameters:
  • Callback API Key: It is the first parameter to protect your callback file.
  • Method: POST
  • saleID: Order number.
  • Name: Name and surname of the payer.
  • Amount: Payment amount.
  • Value: The ID of your paying user. For example: user@gmail.com
  • Secret: Secret token defined on your site.
  • Verify: Required to verify payment.
  • Full response: {"secure":"Callback API Key","name":"Full name","value":"user@gmail.com","amount":"100","verify":"Check code"}

Verify the posted transaction

Verifying the POSTed transaction is very important for transaction security. Using the codes as in the example will improve your security. Below is the example and parameter to verify the payment.

  • Callback API Key: It is the first parameter to protect your callback file.
  • Method: POST
  • saleID: Order number.
  • Name: Name and surname of the payer.
  • Amount: Payment amount.
  • Value: The ID of your paying user. For example: user@gmail.com
  • Secret: Secret token defined on your site.
  • Verify: Required to verify payment.
  • Full response: {"secure":"Callback API Key","name":"Full name","value":"user@gmail.com","amount":"100","verify":"Check code"}
Sample code:

Processing payment

Payment should be processed in your callback file and "1" should be printed on the screen at the end of the transaction.

Sample code:

Withdrawal and processing

You can create and process your withdrawal requests through your own system.

List the banks.

You can make withdrawals from the banks in our system. Use the code below to learn the banks and edit it according to you.

Code:

Create a withdrawal request.

Use the code below to create a withdrawal request. For the bank, please create a withdrawal request using the above active banks (Get banks).

  • Callback API Key: It is the first parameter to protect your callback file.
  • Method: POST
  • withdraw_id: Withdraw number.
  • Name: Name and surname of the payer.
  • Amount: Payment amount.
  • Bank: Bank name.
  • İban: Iban number.
  • Value: The ID of your paying user. For example: user@gmail.com
  • Token: Token on your site.
  • Secret: Secret token defined on your site.
  • Verify: Required to verify payment.
Sample code:

Processing withdraw

The callback you should use to process the pull into your system is as follows. You must do the deduction from the balance within the specified interval.

Sample code: