Paytony

Supports in this guide: Payments

What you need to do for start processing transactions (brief summary)

1. Get your credentials (from Paytony)
2. Connect in Dashboard
3. Send an API request

Prerequisites: get from Paytony

Get the following values for your Paytony account:

• Public Key -> Corefy field public_key -> format: plain value (up to 128 characters) -> where to find: Paytony back office / issued by your Paytony manager
• Private Key -> Corefy field private_key -> format: plain value (up to 128 characters) -> where to find: Paytony back office / issued by your Paytony manager

Only RUB is currently supported for payments.

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "3f8b3468-4e70-40cf-a168-73f13bb27f5e",
      "service": "payment_card_rub_hpp",
      "currency": "RUB",
      "amount": 1200.12
    }
  }
}

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "3f8b3468-4e70-40cf-a168-73f13bb27f5e",
      "service": "payment_card_rub_hpp",
      "currency": "RUB",
      "amount": 1200.12,
      "customer": {
        "reference_id": "122ehjhj123",
        "email": "test@mail.com"
      }
    }
  }
}

Additional info

1. Only RUB is currently supported for payments.
2. Paytony supports 3-D Secure. Depending on the issuer response, the cardholder is redirected to a provider page/ACS using a GET redirect, a POST form (3DS1, fields MD/PaReq/TermUrl), or a 3DS2 challenge (fields cReq/TermUrl) - Corefy handles all these variants automatically.
3. Refunds and recurring (tokenized/card-on-file) payments are not supported by this connector - only a one-off sale and status reconciliation are available.
4. Active reconciliation (payment status check by the original transaction ID) is supported and is used automatically for transactions left in a pending/processing state.
5. If a cardholder name cannot be derived from the card data or from customer.name, Corefy sends the placeholder cardholder name "John Doe" to Paytony instead - there is no Dashboard setting to override this.

FAQ / Troubleshooting

• Invalid credentials / auth error -> verify the Public Key / Private Key pair matches the selected environment (test mode on/off)
• Currency not supported -> only RUB is currently available for this connector
• Payment stuck in Processing/Pending -> Corefy will reconcile the transaction status automatically using the original transaction ID
• Refund or recurring payment requested -> not supported by this connector; contact your Corefy account manager about alternatives
• Not sure which account type to use? -> ask your Corefy account manager