gmopg

Установка

 composer require sanmai/ gmopg

Конфигурация

Существует два способа настройки API:

1. С глобальными константами. А именно, вам необходимо определить:

     // ショップ情報
   define ( ' GMO_SHOP_ID ' , ' tshop0000001 ' ); // ショップＩＤ
   define ( ' GMO_SHOP_PASSWORD ' , ' qwerty ' ); // ショップ名
   define ( ' GMO_SHOP_NAME ' , ' My Shop ' ); // ショップパスワード
   define ( ' GMO_TRIAL_MODE ' , false );

   Где первые три вы можете получить из панели управления или из писем от GMO PG.

   Последняя константа GMO_TRIAL_MODE должна быть установлена ​​в true если вы используете пароль тестового магазина.

2. Вызвав эти статические методы:

    GMO  API Defaults:: setShopID ( $ shopId );
    GMO  API Defaults:: setShopName ( $ shopName );
    GMO  API Defaults:: setPassword ( $ shopPassword );
   
   // When using a test password, this constant is mandatory
   //define('GMO_TRIAL_MODE', true); 

Тестирование платежей

В настоящее время нет другого способа включить тестовый режим, кроме как определить константу GMO_TRIAL_MODE со значением true .

 define ( ' GMO_TRIAL_MODE ' , true );

Для тестирования платежей с помощью непосредственно введенных номеров карт с учетными данными тестовой среды необходимо включить такие платежи, как описано в документации.

Основное использование

 // A wrapper object that does everything for you.
$ payment = new  GMO  ImmediatePayment ();
 // Unique ID for every payment; probably should be taken from an auto-increment field from the database.
$ payment -> paymentId = 123 ;
$ payment -> amount = 1000 ;
// This card number can be used for tests.
$ payment -> cardNumber = ' 4111111111111111 ' ;
// A date in the future.
$ payment -> cardYear = ' 2020 ' ;
$ payment -> cardMonth = ' 7 ' ;
$ payment -> cardCode = ' 123 ' ;

// Returns false on an error.
if (! $ payment -> execute ()) {
	$ errors = $ payment -> getErrors ();
	foreach ( $ errors as $ errorCode => $ errorDescription ) {
        // Show an error code and a description to the customer? Your choice.
        // Probably you want to log the error too.
	}
	return ;
}

// Success!
$ response = $ payment -> getResponse ();
/** @var GMOAPIResponseExecTranResponse $response */
// You would probably want to save the response in the database for future reference.
// The response can be used to query details about a transaction, make refunds and so on.

Массив $errors имеет следующий вид:

 array(1) {
  'E01040010' =>
  string(34) "This order ID was used previously."
}

Список наиболее известных кодов ошибок. В читаемой форме. И еще.

Типичный $response будет выглядеть так:

 class GMOAPIResponseExecTranResponse#1 (9) {
  public $ACS =>
  string(1) "0"
  public $OrderID =>
  string(10) "1517000000"
  public $Forward =>
  string(7) "0afd1200"
  public $Method =>
  string(1) "1"
  public $PayTimes =>
  string(0) ""
  public $Approve =>
  string(7) "0112234"
  public $TranID =>
  string(28) "180111111111111111111344439"
  public $TranDate =>
  string(14) "20221222213141"
  public $CheckString =>
  string(32) "68b329da9893e34099c7d8ad5cb9c940"
}

Оплата жетоном

Объект платежа может принимать токен, полученный от API JavaScript, вместо данных кредитной карты:

 $ payment = new  GMO  ImmediatePayment ();
$ payment -> paymentId = 123 ; // Unique ID for every payment; see above
$ payment -> amount = 1000 ;
// Card details are unnecessary in this case
$ payment -> token = $ _POST [ ' token ' ];

if (! $ payment -> execute ()) {
    // ... same as above
}

// ... same as above

Следует использовать вышеуказанный способ оплаты, если появляется почтенная ошибка E61040001.

Детали транзакции

Теперь вы, естественно, хотите загрузить данные транзакции для текущего платежа.

 $ searchTrade = new  GMO  API  Call  SearchTrade ();
$ searchTrade -> OrderID = $ payment -> getResponse ()-> OrderID ;
// Copy credential from the original payment
$ payment -> setupOther ( $ searchTrade );

$ response = $ searchTrade -> dispatch ();

В этом $response вы найдете следующие поля:

 class GMOAPIResponseSearchTradeResponse#4950 (21) {
  public $AccessID =>
  string(32) "b026324c6904b2a9cb4b88d6d61c81d1"
  public $AccessPass =>
  string(32) "26ab0db90d72e28ad0ba1e22ee510510"
  public $OrderID =>
  string(10) "1517000000"
  public $Status =>
  string(5) "SALES"
  public $ProcessDate =>
  string(14) "20221222213141"
  public $JobCd =>
  string(5) "SALES"
  public $ItemCode =>
  string(7) "0000000"
  public $Amount =>
  string(4) "4999"
  public $Tax =>
  string(1) "0"
  public $SiteID =>
  string(0) ""
  public $MemberID =>
  string(0) ""
  public $CardNo =>
  string(16) "************1111"
  public $Expire =>
  string(4) "2307"
  public $Method =>
  string(1) "1"
  public $PayTimes =>
  string(0) ""
  public $Forward =>
  string(7) "0afd1200"
  public $TranID =>
  string(28) "180111111111111111111344439"
  public $Approve =>
  string(7) "0112234"
  public $ClientField1 =>
  string(0) ""
  public $ClientField2 =>
  string(0) ""
  public $ClientField3 =>
  string(0) ""
}

Дополнительная документация по API

GMO-PG очень скрытны, по-видимому, без всякой причины (это полная противоположность Stripe), и обычно вы можете получить доступ к их документации только после подписания соглашения о неразглашении.