ChangeCoins

Supports in this guide: Payments, Payouts

Provider website: pay.changecoins.io

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

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

Choose account type

ChangeCoins has a single account type that covers both directions:

• Provider account -> used for both payments (crypto, card, and local payment methods) and payouts

If you're not sure whether ChangeCoins fits your use case, confirm with your Corefy account manager.

Prerequisites: get from ChangeCoins

Sign up and complete verification at profit.changecoins.io, then generate API keys in your ChangeCoins merchant back-office.

• Public Key -> Corefy field public_key -> sent on every request as the X-Processing-Key header.
• Secret Key -> Corefy field secret_key -> used to sign every request (X-Processing-Signature header) - store it securely.

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "8e3dbbb0-17af-4c9a-bedb-93bdac6900a2",
      "service": "bitcoin_btc_hpp",
      "currency": "BTC",
      "amount": 0.001
    }
  }
}

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "6795502c-e27d-4d07-85e0-93245aab9a3f",
      "service": "bitcoin_btc_hpp",
      "currency": "BTC",
      "amount": 0.001,
      "customer": {
        "reference_id": "cus_123",
        "email": "johnsmith@gmail.com"
      }
    }
  }
}

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "0dde9e79-2c64-4703-adaf-93d710633401",
      "service": "bitcoin_btc",
      "currency": "BTC",
      "amount": 0.001,
      "customer": {
        "reference_id": "cus_123"
      },
      "fields": {
        "wallet_id": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"
      }
    }
  }
}

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "7976b4ce-fadd-4585-baa0-6b02c65351dc",
      "service": "payment_card_eur",
      "currency": "EUR",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123",
        "name": "John Smith",
        "email": "johnsmith@gmail.com",
        "phone": "+15551234567"
      },
      "fields": {
        "card_number": "4111111111111111"
      }
    }
  }
}

Additional info

1. Callback routing is automatic - Corefy generates the callback URL per transaction, nothing to configure in ChangeCoins' own back-office.

2. Local payment methods available on the Payments flow (actual availability depends on what's enabled for your account):

   Category	Methods / currencies	Service pattern
   Crypto	Bitcoin, Ethereum, Binance Coin, Dogecoin, Tether (ERC-20 and TRC-20)	<coin>_<ccy>_hpp
   Card	UAH, KZT, EUR, USD, RUB, NGN, GHS, KES, UGX, GBP, AZN, INR, UZS, TRY, MDL, AED, EGP, IDR, KRW, MXN	payment_card_<ccy>_hpp
   Bank transfer	NGN, KRW	bank_transfer_<ccy>_hpp
   Mobile money	KES, UGX, EGP	mobile_<ccy>_hpp
   UPI / Net Banking	INR	upi_inr_hpp / net_banking_inr_hpp
   Aggregated wallet	PKR	wallet_aggregated_pkr_hpp

3. Payout destinations available on the Payouts flow (actual availability depends on what's enabled for your account): crypto (Bitcoin, Ethereum, Binance Coin, Dogecoin, Tether ERC-20/TRC-20 - also available in UAH), card payouts in the same currency list as Payments above (plus CNY), India bank transfer/UPI, generic Nigerian bank transfer, and ~20 individual Nigerian bank payout routes (e.g. GTBank, Zenith Bank, UBA, Access Bank, First Bank of Nigeria, and others), each with its own service code and fields.account_number - ask your Corefy account manager for the exact list of bank-specific service codes available to your account.

FAQ / Troubleshooting

• Invalid credentials / auth error -> verify the Secret Key used to connect matches the API key currently active in your ChangeCoins account
• A currency/method I expect isn't available -> confirm it's enabled on your ChangeCoins merchant account and reflected in the Dashboard's Currency/Features selector for this connection
• Not sure which account type to use? -> ask your Corefy account manager