PayFuture¶

The Local Payments Connector for Emerging Markets. Opening a world of opportunities for global expansion.

Set up Account¶

Step 1: Create Provider account¶

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

Mid code
Mid Secret

Connect Provider Account¶

Step 1. Connect Provider account at the Corefy Dashboard¶

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

Connect

Enter credentials:

mid_code → Mid code
mid_secret → Mid Secret

Success

You have connected PayFuture Provider account!

API examples¶

Data set to create a Payment (paytm_inr_hpp):¶

PAYMENT

POST /api/commerce/payment-invoices HTTP/1.1
{
   "data":{
      "type":"payment-invoice",
      "attributes":{
         "service":"paytm_inr_hpp",
         "commerce_account":"Hello_World",
         "currency":"INR",
         "amount":123,
         "flow":"charge",
         "gateway_options":{
            "cardgate":{
               "tokenize":""
            }
         },
         "customer":{
            "reference_id":"865e4813-0b82-493b-a573-95b7ce07b538"
         },
         "test_mode":true,
         "options":{
            "allow_partially":false
         },
         "reference_id":"bda26b6b-587e-4cc9-884c-4f6811f43ee7",
         "service_fields":[

     ]
  }
}
}

Data set to create a Payment (hdfc_bank_inr_hpp):¶

PAYMENT

POST /api/commerce/payment-invoices HTTP/1.1
{
   "data":{
      "type":"payment-invoice",
      "attributes":{
         "service":"hdfc_bank_inr_hpp",
         "commerce_account":"Hello_World",
         "currency":"INR",
         "amount":999,
         "flow":"charge",
         "gateway_options":{
            "cardgate":{
               "tokenize":""
            }
         },
         "customer":{
            "reference_id":"7ae5d1df-a316-4c9c-af9c-ccaed8a29e8f",
            "name":"Test Test",
            "email":"[email protected]",
            "phone":"12345678995",
            "address":{
               "full_address":"India",
               "country":"IN",
               "region":"India",
               "city":"India",
               "street":"India",
               "post_code":"12345"
            }
         },
         "test_mode":true,
         "options":{
            "allow_partially":false
         },
         "reference_id":"7c626240-d798-4171-aa15-85a05e4a37cd",
         "service_fields":[

     ]
  }
}
}

Data set to create a Payment (upi_qr_inr_invoice):¶

PAYMENT

POST /api/commerce/payment-invoices HTTP/1.1
{
   "data":{
      "type":"payment-invoice",
      "attributes":{
         "service":"upi_qr_inr_invoice",
         "commerce_account":"Hello_World",
         "currency":"INR",
         "amount":123.45,
         "flow":"charge",
         "gateway_options":{
            "cardgate":{
               "tokenize":""
            }
         },
         "customer":{
            "reference_id":"865e4813-0b82-493b-a573-95b7ce07b538"
         },
         "test_mode":true,
         "options":{
            "allow_partially":false
         },
         "reference_id":"1c222043-420e-494e-bf4a-0d777ed24ce7",
         "service_fields":{
            "vpa":"tets@test",
            "document_id":"test",
            "document_type":"test",
            "bank_code":"test",
         }
      }
   }
}

Data set to create a payment invoices for upi_inr_invoice service¶

PAYMENT

POST /api/commerce/payment-invoices HTTP/1.1
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"upi_inr_invoice",
      "commerce_account":"Hello_World",
      "currency":"INR",
      "amount":987.65,
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"865e4813-0b82-493b-a573-95b7ce07b538",
        "name":"Test Test",
        "phone":"12345678995",
        "email":"[email protected]",
        "address": {
          "full_address":"India",
          "country":"IN",
          "state": "Karnataka",
          "city":"India",
          "post_code":"12345",
        }
      },
      "metadata": {
        "fingerprint": "1234"
      },
      "test_mode":true,
      "options":{
        "allow_partially":false
      },
      "reference_id":"1c222043-420e-494e-bf4a-0d777ed24ce7",
      "service_fields":{
        "vpa":"tets@test",
        "document_id":"test",
        "document_type":"test",
        "bank_code":"test",
      }
    }
  }
}

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

PAYOUT

POST /api/payout-invoices HTTP/1.0
{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "test_mode": true,
      "reference_id": "234234234234}",
      "description": "string",
      "currency": "INR",
      "amount": 100,
      "service": "bank_transfer_inr",
      "service_amount": 60,
      "fields": {
        "beneficiary_full_name": "john smith",
        "beneficiary_country_code_iso": "NG",
        "account_number": "2000017251",
        "bank_code": "NA",
        "bank_name": "NA",
        "bank_branch": "NA",
        "beneficiary_phone": "9876543210",
        "beneficiary_email": "[email protected]",
        "account_type": "BANKTRANSFER",
        "bank_branch_code": "NG1084",
        "beneficiary_postcode": "123456",
        "beneficiary_state": "string"
      },
      "callback_url": "https:\/\/example.com\/payouts\/callback",
      "options": {
        "auto_process": true
      }
    }
  }
}

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

PAYOUT

POST /api/payout-invoices HTTP/1.0
{
  "data":{
    "type":"payout-invoice",
    "attributes":{
      "test_mode":true,
      "reference_id":"1733842885",
      "description":"string",
      "currency":"INR",
      "amount":100,
      "service":"bank_transfer_inr",
      "service_amount":60,
      "customer":{
        "reference_id":"66ddb3c7553ce85a2cd5d810",
        "metadata":{
          "client_ip":"3.65.180.235"
        }
      },
      "fields":{
        "beneficiary_full_name":"john smith",
        "beneficiary_country_code_iso":"NG",
        "account_number":"2000017251",
        "bank_code":"NA",
        "bank_branch_code":"NG1084",
        "bank_name":"NA",
        "bank_branch":"NA",
        "bank_address":"NA",
        "beneficiary_phone":"9876543210",
        "beneficiary_email":"[email protected]",
        "beneficiary_address":"in",
        "account_type":"BANKTRANSFER",
        "beneficiary_document_id":"123",
        "beneficiary_city":"surat",
        "beneficiary_name":"john",
        "beneficiary_lastname":"smith",
        "beneficiary_postcode":"123456",
        "beneficiary_state":"string",
        "beneficiary_document_type":"string"
      },
      "callback_url":"https:\/\/example.com\/payouts\/callback",
      "options":{
        "auto_process":true
      }
    }
  }
}

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:

CLIENT_IP → data ['ipaddress'] → customer['metadata']

Question

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