Merchant Yöntemi

Bir müşterinin WISECP'den ayrılmadan kredi kartı bilgilerini girdiği yerdir. Süreçler arka planda işlenir.  Kullanıcınız 3D güvenlik doğrulaması için sitenizden ayrılabilir veya bir popup görebilir. 

"Merchant" yöntemine göre modül oluşturmak için aşağıdaki adımları takip ediniz.

Modülde bulunan sınıf içerisine "capture" adında bir fonksiyon tanımlayın. Bu fonksiyonun kullanım amacı müşteriden temin edilen kredi kartı bilgilerini "capture" fonksiyonuna aktarmaktır. Genellikle ödeme hizmeti sağlayıcısına "HTTP/cURL" isteği göndererek gelen cevaba göre ödemeyi onaylamak için kullanılır.

Eğer ödeme hizmeti sağlayıcınız "3D Secure" ile ödemeyi destekliyorsa, "3D Secure" dokümana göz atınız.

Eğer ödeme hizmeti sağlayıcınız, ödeme iade etme özelliğini destekliyorsa, "İade" dokümanına göz atınız.

Değişkenler

Aşağıda belirtilen tüm değişkenler, "capture" fonksiyonuna iletilmektedir.

Sistem Değişkenleri

 $this->config["settings"]["...your_field..."] # Custom configuration field
 $this->name                   # Module Name
 $this->lang["invoice-name"]   # Module Display Name
 $this->url                    # Module Directory URL Address
 $this->dir                    # Module Directory Path (eg. /coremio/modules/Payment/SamplePay/)
 $this->lang["example"]        # Calling a field from a language file
 APP_URI                       # Website URL Address
 $this->links["successful"]    # Payment successful page link
 $this->links["failed"]        # Payment failed page link
 $this->links["callback"]      # Callback link

Yanıt

Fonksiyonun geri dönüş değeri bir "dizi" olmalı ve aşağıdaki değerleri döndürmelidir.

Örnek

Aşağıdaki örnekte bir URL adresine cURL kütüphanesi kullanarak "HTTP/POST" isteği gönderilmektedir. İsteğin gönderilmesinden sonra, gelen yanıt "JSON" çıktısı içermektedir.

public function capture($params=[])
{
    $api_key            = $this->config["settings"]["example1"] ?? 'N/A';
    $secret_key         = $this->config["settings"]["example2"] ?? 'N/A';
    $fields             = [
        'client' => [
            'first_name'    => $params["clientInfo"]->name,
            'last_name'     => $params["clientInfo"]->surname,
            'email'         => $params["clientInfo"]->email,
            'address'       => [
                'country'       => $params["clientInfo"]->address->country_code,
                'city'          => $params["clientInfo"]->address->city,
                'state'         => $params["clientInfo"]->address->counti,
                'postcode'      => $params["clientInfo"]->address->zipcode,
                'detail'        => $params["clientInfo"]->address->address,
            ],
        ],
        'card'              => [
            'card_number'        => $params['num'],
            'card_holder_name'   => $params['holder_name'],
            'card_expiry'        => $params['expiry_m']."-".$params['expiry_y'],
            'card_cvc'           => $params['cvc'],
        ],
        'amount'                => $params['amount'],
        'currency'              => $this->currency($params['currency']),
        'custom_id'             => $params["checkout_id"],
    ];

    // Here we are making an API call.
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, "api.sample.com/checkout/capture");
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
    curl_setopt($curl, CURLOPT_HTTPHEADER, array(
        'APIKEY: '.$api_key,
        'SECRET: '.$secret_key,
        'Content-Type: application/json',
    ));
    curl_setopt($curl,CURLOPT_POST,1);
    curl_setopt($curl,CURLOPT_POSTFIELDS,http_build_query($fields));
    $result = curl_exec($curl);
    if(curl_errno($curl))
    {
        return [
            'status' => 'error',
            'message' => curl_error($curl)
        ];
    }
    $result             = json_decode($result,true);

    if($result && $result['status'] == 'success')
        return [
            'status' => 'successful',
            'message' => ['Merchant Transaction ID' => $result['transaction_id']],
        ];
    else
        return [
            'status'            => 'error',
            'message'           => $result['error_message'] ?? '!API ERROR!',
        ];

}