Skip to content

Logo

Paytocrypt

Supports in this guide: Payments

Provider website: paytocrypt.com

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

  1. Choose account type
  2. Get your credentials (from Paytocrypt)
  3. Connect in Dashboard
  4. Send an API request

Choose account type

Paytocrypt can be connected in different ways (depending on your needs):

  • If you do H2H card payments -> choose H2H Merchant account

If you are not sure which one to use, confirm with your Corefy account manager.

Prerequisites: get from Paytocrypt

Get the following values for your Paytocrypt project/account:

  • Login -> Corefy field login -> example: merchant_login -> where to find: Paytocrypt backoffice / issued by Paytocrypt manager
  • Password -> Corefy field password -> example: Str0ngP@ssword -> where to find: Paytocrypt backoffice / issued by Paytocrypt manager
  • Private Key -> Corefy field private_key -> uploaded as a file; generate a private/public key pair according to Paytocrypt's guidelines and send the public key to Paytocrypt
Payments processing (connect H2H Merchant account, create payment-invoice)

Connect H2H Merchant account in Corefy Dashboard

Step 1 - Open connection form

Open Paytocrypt in the provider directory and press Connect at Paytocrypt Provider Overview page in the New connection section. Choose H2H Merchant account.

Step 2 - Fill in fields and select settings

  • Login
  • Password
  • Private Key -> upload the private key file you generated (the matching public key must be forwarded to Paytocrypt beforehand)
  • Test Mode -> (enable if you are using sandbox credentials)

Choose Currency and Features. You can set these parameters according to available currencies and features for your Paytocrypt account, but it is necessary to check details of the connection with your Corefy account manager.

Success

You have connected Paytocrypt H2H Merchant account!

First request to Corefy API (MIN)

What it does: creates a payment-invoice.

Payment - MIN

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "86e68af6-6b95-4cc0-be16-e4df8044604c",
      "service": "payment_card_usd_hpp",
      "currency": "USD",
      "amount": 10,
      "flow": "charge",
      "test_mode": true
    }
  }
}
customer is entirely optional here - Paytocrypt's own request builder works with no customer object in the request at all. If you do send customer.reference_id, it's forwarded to Paytocrypt as the order's client ID; customer.name feeds the card's holder_name field, but only when the card data submitted for the transaction doesn't already carry a cardholder name of its own. When neither source provides a name, Corefy sends a fixed placeholder (John Doe) to Paytocrypt instead of leaving holder_name blank - send a real name (via the card data or customer.name) if you don't want Paytocrypt to receive placeholder data instead of your customer's.

Payment - MAX

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "08f5e97c-1170-4bda-9625-3bde3c6dcd20",
      "service": "payment_card_usd_hpp",
      "currency": "USD",
      "amount": 10,
      "flow": "charge",
      "test_mode": true,
      "customer": {
        "reference_id": "bc75bc54-5023-4f98-8c0d-ec5ed7e8f380",
        "name": "John Smith"
      }
    }
  }
}

Extended request (MAX)

Why add extra fields (typical reasons): - Provide additional customer details for compliance/reconciliation - Positively influence conversion rate - Include optional fields required by your specific flow

Refunds

Paytocrypt supports refunds, but only a single, full refund per payment - partial and multiple/split refunds aren't supported.

If you don't provide a refund description, Corefy sends a fixed placeholder reason (Some reason) to Paytocrypt instead of leaving the refund reason blank.

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify credentials for the selected environment and account type
  • Currency or service is not supported -> confirm allowed currencies/features in your Paytocrypt account and in Corefy
  • Missing required fields -> provide missing request fields in the API request
  • Not sure which account type to use? -> ask your Corefy account manager

Question

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