TwoPayLer¶

Website: 2payler.cash

Set up Account¶

Step 1: Create merchant account¶

To create an account send connection request at the 2payler.cash 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:

• API key
• Secret key

Connect Provider Account¶

Step 1. Connect Provider account at the Corefy Dashboard¶

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

Enter credentials:

• api_key → API key
• secret_key → Secret key

You have connected TwoPayLer Provider account!

API examples:¶

Data set to create a payment:¶

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

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "service": "card_transfer_uah_hpp",
      "commerce_account": "HELLO WORLD",
      "currency": "UAH",
      "amount": 600,
      "flow": "charge",
      "test_mode": false,
      "options": {
        "allow_partially": false
      },
      "reference_id": "b4080027-761a-443a-915f-64be6b893f64"
    }
  }
}

Data set to create a payout:¶

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

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "service": "payment_card_uah",
      "commerce_account": "Hello World",
      "currency": "UAH",
      "amount": 500,
      "reference_id": "f83224da-1bf4-4d07-8d79-a64700505c5a",
      "customer": {
        "reference_id": "cac2e7aa-4ac5-4574-aac3-7c9501355f0c",
        "name": "Test Test"
      },
      "test_mode": false,
      "fields": {
        "card_number": "510510******5100"
      },
      "options": {
        "attempts_limit": 0,
        "split_mode": false,
        "allow_partially": false,
        "auto_process": false
      }
    }
  }
}

Additional information¶

Constants¶

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:

• FULL_ADDRESS → customer [address] [fullAddress]
• REGION → customer [address] [region]
• COUNTRY → customer [address] [country]
• CITY → customer [address] [city]
• POST_CODE → customer [address] [postCode]
• EMAIL → customer [email]
• NAME→ customer [name]
• PHONE → customer [phone]
• LANG → language

Provider Options¶

• finalize_by_protocol
  • The provider does not guarantee the finality of the fail status because in their system it can later change to success and if the merchant does not agree with this logic then there is no need to enable this option.
    • Then we (Corefy) will stop failing payments but the merchant will not receive transaction status discrepancies.
  • If a merchant wants to fail decline which the provider does not guarantee then you need to enable this option.

Please contact our support team!