README

Nomuvel, Nomupay API ile entegre olmanızı sağlayan bir Laravel wrapperıdır. Bu paket, Nomupay API'sindeki çeşitli işlemleri basit ve kolay kullanımlı bir Laravel arabirimi aracılığıyla gerçekleştirmenizi sağlar.

Özellikler

• E-Money API ile entegrasyon
• Individual Onboarding API entegrasyonu

Kurulum

1. Projeye paketi ekleyin:

   composer require yigitbayol/nomuvel

2. Konfigürasyon dosyasını yayınlayın:

   php artisan vendor:publish --tag=nomuvel-config

3. .env dosyanıza gerekli API bilgilerini ekleyin:

   NOMUVEL_ENV=dev
   NOMUVEL_TEST_URL=https://api-dev.nomupay.com.tr
   NOMUVEL_PRODUCTION_URL=https://api.nomuvel.com.tr
   NOMUVEL_USER_CODE=123456
   NOMUVEL_PIN=6A262E9E910364A9D7D0
   NOMUVEL_CHANNEL=MYAPP

Kullanım

E-Money API Örnekleri

E-Money Hesap Oluşturma

use Yigitbayol\Nomuvel\Services\Nomuvel;

/**
 * Yeni bir E-Money hesabı oluşturun
 *
 * @param string $tckn "11111111111"
 * @param string $iban "TR1312312321312312"
 * @param string $successUrl "https://nomupay.com.tr/success"
 * @param string $errorUrl "https://nomupay.com.tr/fail"
 * @return array
 * @throws ConnectionException
 */
$nomuvel = new Nomuvel();
$response = $nomuvel->emoney->createAccount("11111111111", "TR1312312321312312", "https://nomupay.com.tr/success", "https://nomupay.com.tr/fail");

if ($response['error']) {
    // Hata yönetimi
    echo $response['message'];
} else {
    // Başarılı yanıt yönetimi
    print_r($response);
}

IBAN'a Para Gönderme

use Yigitbayol\Nomuvel\Services\Nomuvel;

/**
* IBAN'a para gönderin
*
* @param string $senderClientId "34a4cae28-622d-48b3-86b7-1a3cde436d31"
* @param string $senderAccountId "85a4cde28-622d-48b3-1a3cde436d31"
* @param string $receiverIBAN "TR1111111111111111"
* @param string $receiverTcknVkn "12345678910"
* @param int $amount "1 TL için 100"
* @param string $partnerReference "3e4cae28-622d-48b3-86b7-1a3cde436d31"
* @param string|null $description "Test"
* @return array
* @throws ConnectionException
  */
  $nomuvel = new Nomuvel();
  $response = $nomuvel->emoney->sendToExternalIBAN("34a4cae28-622d-48b3-86b7-1a3cde436d31", "85a4cde28-622d-48b3-1a3cde436d31", "TR1111111111111111", "12345678910", 100, "3e4cae28-622d-48b3-86b7-1a3cde436d31", "Test");

if ($response['error']) {
// Hata yönetimi
echo $response['message'];
} else {
// Başarılı yanıt yönetimi
print_r($response);
}

P2P Para Gönderimi

use Yigitbayol\Nomuvel\Services\Nomuvel;
/**
 * P2P para gönderin
 *
 * @param string $senderAccountId "85a4cde28-622d-48b3-1a3cde436d31"
 * @param string $receiverAccountId "3e4cae28-622d-48b3-86b7-1a3cde436d31"
 * @param int $amount "1 TL için 100 girilmelidir"
 * @param string $referenceId "3e4cae28-622d-48b3-86b7-1a3cde436d31"
 * @param int $partnerId 0
 * @param string|null $description "Test"
 * @return array
 * @throws ConnectionException
 */
$nomuvel = new Nomuvel();
$response = $nomuvel->emoney->P2PSend("85a4cde28-622d-48b3-1a3cde436d31", "3e4cae28-622d-48b3-86b7-1a3cde436d31", 100, "3e4cae28-622d-48b3-86b7-1a3cde436d31", 0, "Test");

if ($response['error']) {
    // Hata yönetimi
    echo $response['message'];
} else {
    // Başarılı yanıt yönetimi
    print_r($response);
}

Para Çekme

use Yigitbayol\Nomuvel\Services\Nomuvel;
/**
 * E-Money hesabından para çekin
 *
 * @param string $accountId "85a4cde28-622d-48b3-1a3cde436d31"
 * @param int $amount "1 TL için 100 değeri girilmeli"
 * @param string $transferChannel "Ozan,Papara vb.."
 * @param string $referenceId "3e4cae28-622d-48b3-86b7-1a3cde436d31"
 * @param string $transferType "INSTANT veya GROUP"
 * @param string|null $transferDate "Sadece INSTANT için zorunludur. 2024-08-14T09:45:02.289Z"
 * @param string|null $description "Test"
 * @return array
 * @throws ConnectionException
 */
$nomuvel = new Nomuvel();
$response = $nomuvel->emoney->withdrawal("85a4cde28-622d-48b3-1a3cde436d31", 100, "Ozan", "3e4cae28-622d-48b3-86b7-1a3cde436d31", "INSTANT", "2024-08-14T09:45:02.289Z", "Test");

if ($response['error']) {
    // Hata yönetimi
    echo $response['message'];
} else {
    // Başarılı yanıt yönetimi
    print_r($response);
}

API Dökümantasyonu

Nomuvel, aşağıdaki API endpointlerini desteklemektedir:

E-Money API

• CreateAccountWithTckn
• SendToExternalIBAN
• P2PSend
• Withdrawal

Individual Onboarding API

• Create
• Validate Otp Token
• Get By Tckn
• Query By Tckn
• Add To E-Money

Daha fazla bilgi için E-Money API Dokümantasyonu ve Individual Onboarding API Dokümantasyonu sayfalarına göz atabilirsiniz.

Lisans Bu proje MIT Lisansı ile lisanslanmıştır. Daha fazla bilgi için LICENSE dosyasına bakabilirsiniz.