TopPay¶

TopPay. Preferred Aggregate Payment Instrument in Indonesia

Set up Account Provider account¶

Step 1: Create Provider account¶

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

toppay__merchant_id → Merchant Number
toppay__public_key → Public Key
toppay__private_key → Private Key
toppay__test_mode → true/false

Connect Provider Account¶

Step 1. Connect Provider account at the Corefy Dashboard¶

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

Connect

Enter credentials:

Merchant ID
Public Key
Private key

Success

You have connected TopPay Provider account!

API examples:¶

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

PAYMENT

POST /api/commerce/payment-invoices HTTP/1.0

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "service": "pix_brl_hpp",
      "commerce_account": "Hello_World",
      "currency": "BRL",
      "amount": 14,
      "flow": "charge",
      "gateway_options": {
        "cardgate": {
          "tokenize": ""
        }
      },
      "test_mode": true,
      "options": {
        "allow_partially": false,
        "bypass_hpp": false,
        "send_operation_context_on_return": false
      },
      "reference_id": "e4fdf9f3-2ca0-44d8-a6ce-97b2783dc366",
      "service_fields": []
    }
  }
}

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

PAYMENT

POST /api/commerce/payment-invoices HTTP/1.0

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "service": "pix_brl_hpp",
      "commerce_account": "Hello_World",
      "currency": "BRL",
      "amount": 11,
      "flow": "charge",
      "gateway_options": {
        "cardgate": {
          "tokenize": ""
        }
      },
      "customer": {
        "reference_id": "9768334b-f707-4b2b-b576-2694f7c11fe0",
        "metadata": {
          "ip": "192.168.0.1"
        }
      },
      "test_mode": true,
      "options": {
        "allow_partially": false,
        "bypass_hpp": false,
        "send_operation_context_on_return": false
      },
      "reference_id": "8f79bad7-5387-4872-9873-12fc3866164b",
      "service_fields": {
        "cpf_number": "11111111111",
        "phone": "+11111111111",
        "email": "[email protected]",
        "payer_first_name": "Test",
        "payer_last_name": "User"
      }
    }
  }
}

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

PAYOUT

POST /api/commerce/payout-invoices
{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "service": "pix_brl",
      "commerce_account": "Hello World",
      "currency": "BRL",
      "amount": 11,
      "test_mode": false,
      "reference_id": "f2ebf078-6e5e-46ba-aab8-7081d52e7917",
      "fields": {
        "cpf_number": "099.142.639-84",
        "beneficiary_name": "Vinicius dos",
        "beneficiary_lastname": "Reis Appolinario",
        "account_type": "CPF"
      },
      "options": {
        "attempts_limit": 0,
        "split_mode": false,
        "allow_partially": false,
        "auto_process": false
      }
    }
  }
}

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

PAYOUT


POST /api/commerce/payout-invoices HTTP/1.0
{
  "data":{
    "type":"payout-invoice",
    "attributes":{
      "service":"pix_brl",
      "commerce_account":"Hello_World",
      "currency":"BRL",
      "amount":12,
      "test_mode":true,
      "reference_id":"0682d941-de11-4bbe-a461-e44e462729a5",
      "fields":{
        "cpf_number":"123",
        "beneficiary_phone":"+1111111111",
        "beneficiary_phone_country_code":"+380",
        "beneficiary_phone_area_code":"12",
        "beneficiary_email":"[email protected]",
        "beneficiary_name":"Test",
        "beneficiary_lastname":"Test",
        "bank_code":"123",
        "bank_agency_number":"123",
        "account_number":"12345678",
        "pix_key":"****5678",
        "bank_isbp_code":"12345678",
        "bank_branch_code":"11",
        "account_number_checksum":"12345678",
        "document_type":"CPF",
        "document_id":"12345678",
        "account_type":"EMAIL",
        "bank_account_type":"personal"
      },
      "options":{
        "attempts_limit":0,
        "split_mode":false,
        "allow_partially":false,
        "auto_process":false
      }
    }
  }
}

Question

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