<div id="readability-page-1" class="page"><div><figure data-origin-width="800" data-origin-height="420" data-ke-mobilestyle="alignCenter"><span data-url="https://blog.kakaocdn.net/dn/vriyL/btrx6n4ddKX/30S6gY6mWbtaXWK0UZIu8K/img.png" data-lightbox="lightbox" data-alt=""><img src="https://blog.kakaocdn.net/dn/vriyL/btrx6n4ddKX/30S6gY6mWbtaXWK0UZIu8K/img.png" data-filename="iamport.png" data-ke-mobilestyle="alignCenter"></span></figure>
<p data-ke-size="size16">이번에 국내 서비스용 결제와 관련된 기능을 구현해보면서 사용해본 것이 <a href="https://www.iamport.kr/" target="_blank" rel="noopener">아임포트(I'mport)</a>다. 라라벨에는 물론 결제를 위한 <b>Laravel Cashier</b> 라는 패키지가 존재하고, <a href="https://stripe.com/" target="_blank" rel="noopener">Stripe</a>, <a href="https://www.paddle.com/" target="_blank" rel="noopener">Paddle</a> 과 연동할 수 있으나 국내 서비스에는 그다지 친화적이지 않은 측면이 있다. 따라서 구축하기도 쉽고 국내 서비스에 친화적인 아임포트를 사용해보기로 했다. 또 다른 국내 친화적인 서비스로는 <a href="https://payple.kr/" target="_blank" rel="noopener">Payple</a> 이 있는데, 나중에 기회가 되면 써보기로 하자.</p>

<p data-ke-size="size16">아임포트는 개발자 친화적으로 문서화가 되어있어서 개발자의 입장에서 볼 때 결제를 구현하기 상당히 수월하게 되어있다. 대표적으로 <b>일반결제, 정기결제, 결제환불</b> 이렇게 세가지로 되어있다. 자세한 내용을 확인하려면 아래의 문서를 참고하자. 우리가 구현할 것은 일반결제 하나 뿐이다.</p>

<p data-ke-size="size16"><a href="https://docs.iamport.kr/" target="_blank" rel="noopener">https://docs.iamport.kr/</a></p>
<h2 data-ke-size="size26">아임포트</h2>
<p data-ke-size="size16">아임포트와 같은 중개자를끼면 PG사의 모듈을 직접 연계했을 때와는 결제과정이 다소 바뀌게 되는데, 그림으로 한 눈에 알 수 있다.</p>
<figure><p><span data-url="https://blog.kakaocdn.net/dn/bbZ1Wr/btrx2elXSHx/CeYCK41xtPDWnKaHn1vqlk/tfile.svg" data-lightbox="lightbox" data-origin-width="740" data-origin-height="500" data-filename="iamport-1.svg" data-widthpercent="46.84"><img src="https://blog.kakaocdn.net/dn/bbZ1Wr/btrx2elXSHx/CeYCK41xtPDWnKaHn1vqlk/tfile.svg"></span><span data-url="https://blog.kakaocdn.net/dn/nriHk/btrx5uohbZM/PCAodSOKBUofVN6li4Z9eK/tfile.svg" data-lightbox="lightbox" data-is-animation="undefined" data-origin-width="840" data-origin-height="500" data-filename="iamport-2.svg" data-widthpercent="53.16"><img src="https://blog.kakaocdn.net/dn/nriHk/btrx5uohbZM/PCAodSOKBUofVN6li4Z9eK/tfile.svg"></span></p><figcaption>PG사 모듈 직접 연계(좌) / 아임포트(우)</figcaption></figure>
<p data-ke-size="size16"><span>중개자가 있기때문에 과정이 조금은 더 복잡해질 수 있지만, 사실 아임포트를 <b>인터페이스(Interface)</b>의 관점으로 접근해본다면, 다양한 PG사에 연동하고 싶은 경우에 각각이 다른 구현방식을 취할 필요가 없고 개발자의 입장에서는 단순 파라매터만 바꾸는 것으로 사용할 수 있는 것이다.</span></p>
<h3 data-ke-size="size23">이미테이션</h3>
<p data-ke-size="size16"><span>아임포트 내부에서 하는 일을 코드로<span>&nbsp;</span></span><b>느낌만</b><span><span>&nbsp;</span>간략하게 살펴보면 아래와 같다. 실제로 이렇지는 않을 것이다. 그저 아임포트가 각 PG사와 중개자 역할을 한다는점에 초점을 맞춘다.</span></p>

<p data-ke-size="size16">먼저, 각 <code>KGInicis, KakaoPay</code> 등의 PG사를 각각 만들어주자. 여기서 <code>Context</code> 클래스에 들어갈만한 것들은 카드, 가상계좌 등의 결제방법, 주문가격 등이 프로퍼티로 존재할 수 있다.</p>
<pre id="code_1648788833226" data-ke-language="php" data-ke-type="codeblock"><code>class Context 
{
    // 결제방법, 주문가격 등...
}

abstract class Pg {
    /**
     * Request Payment
     * 
     * @param Context $context
     * @return bool
     */
    public abstract function requestPay(Context $context): bool;
}

/**
 * KG이니시스
 */
class KGInicis extends Pg
{
    public function requestPay(Context $context): bool
    {
        //
    }
}

/**
 * 카카오페이
 */
class KakaoPay extends Pg
{
    public function requestPay(Context $context): bool
    {
        //
    }
}</code></pre>
<p data-ke-size="size16">그 다음 <code>Iamport</code> 클래스를 하나 만들고 생성자에 사용하고자하는 PG사에 해당하는 클래스를 주입, PG사에서 구현 중인 <code>Pg::requestPay()</code> 를 호출, 고유주문번호를 생성해서 반환한다. 여기까지가 대략적으로 아임포트 내부에서 발생할 수 있는 일이다.</p>
<pre id="code_1648789309101" data-ke-language="php" data-ke-type="codeblock"><code>class Iamport 
{
    /**
     * 고유주문번호
     * 
     * @var string $impUid
     */
    private $impUid;

    /**
     * PG
     * 
     * @var Pg $pg
     */
    private $pg;

    /**
     * Create Iamport Instance
     * 
     * @param Pg $pg
     */
    public function __construct(Pg $pg) 
    {
        $this-&gt;pg = $pg;
    }

    /**
     * Request Payment
     * 
     * @param Context $context
     * @return string
     */
    public function requestPay(Context $context): string
    {
        if (! $this-&gt;pg-&gt;requestPay($context)) {
            return '';
        }

        // 아임포트 고유 주문번호 생성 및 저장...

        return $this-&gt;impUid;
    }
}</code></pre>
<p data-ke-size="size16">이렇게 작성된 모듈을 클라이언트에선 어떻게 해야할까? 그저 아임포트에서 어떤 PG사와 연동할지만 넘겨주고 요청만 보내면 그만이다. 실제로 이러한 사용법은 우리가 아임포트를 클라이언트의 입장에서 사용하는 방법과 아주 유사하다고 볼 수 있다.</p>
<pre id="code_1648791853350" data-ke-language="php" data-ke-type="codeblock"><code>$iamport = new Iamport(new KGInicis());

$context = new Context();
if ($impUid = $iamport-&gt;requestPay($context)) {
    //
}</code></pre>
<h2 data-ke-size="size26">라라벨에서 아임포트 연동준비하기</h2>
<p data-ke-size="size16"><u><b>라라벨 8.x</b></u> 에서 실제 아임포트 모듈을 사용하여 실제를 만들어보자. 라라벨 프로젝트를 만드는 것부터 시작이다.</p>
<pre id="code_1648795363256" data-ke-language="bash" data-ke-type="codeblock"><code>laravel new iamport-payments</code></pre>
<h3 data-ke-size="size23">설정</h3>
<p data-ke-size="size16">아임포트에 대한 설정을 추가해주자. 아임포트 <b>관리자 콘솔 - 내정보</b>에서 클라이언트 <u><b>키(Key)</b></u>와 <u><b>시크릿 키</b></u>를 확인할 수 있는데, <b>.env, app/services.php</b> 에 값을 설정해주자.</p>
<figure data-origin-width="1018" data-origin-height="340" data-ke-mobilestyle="alignCenter"><span data-url="https://blog.kakaocdn.net/dn/zahNf/btrydhpf1KC/9K6kIZEhYtsiH3s0fnhZXK/img.png" data-lightbox="lightbox" data-alt="관리자 콘솔 - 내정보"><img src="https://blog.kakaocdn.net/dn/zahNf/btrydhpf1KC/9K6kIZEhYtsiH3s0fnhZXK/img.png" data-filename="iamport-01.PNG" data-ke-mobilestyle="alignCenter"></span><figcaption>관리자 콘솔 - 내정보</figcaption></figure>
<h4 data-ke-size="size20">config/services.php</h4>
<p data-ke-size="size16">아래의 설정은 정해진 설정이 아니라 임의로 추가한 것이기 때문에 필요하다면 수정할 수 있다. 이 경우 <code>merchant_id</code> 는 가맹점 식별코드를 말하는데 아임포트 관리자 콘솔에서 볼 수 있다. 마찬가지로 <code>client_id, client_secret</code> 도 확인할 수 있다. <code>pg</code> 의 경우 사용할 PG사의 식별 이름을 적으면 되는데, <a href="https://docs.iamport.kr/sdk/javascript-sdk#request_pay" target="_blank" rel="noopener">Javascript SDK</a> 에서 <code>IMP.requestPay()</code> 의 명세에서 <code>pg</code> 항목을 보면 된다.</p>
<pre id="code_1648796271403" data-ke-language="bash" data-ke-type="codeblock"><code>'iamport' =&gt; [
    'merchant_id' =&gt; env('IAMPORT_MERCHANT_ID'),
    'pg' =&gt; env('IAMPORT_PG'),
    'client_id' =&gt; env('IAMPORT_CLIENT_ID'),
    'client_secret' =&gt; env('IAMPORT_CLIENT_SECRET')
],</code></pre>
<h4 data-ke-size="size20">.env</h4>
<p data-ke-size="size16">다음과 같이 지정하고, 빈칸에는 관리자 콘솔에서 값을 보고 넣어주자. <code>IAMPORT_PG</code> 에 설정된 <code>html5_inicis</code> 는 KG이니시스를 의미한다.</p>
<pre id="code_1648797112485" data-ke-language="php" data-ke-type="codeblock"><code>IAMPORT_MERCHANT_ID=
IAMPORT_PG=html5_inicis
IAMPORT_CLIENT_ID=
IAMPORT_CLIENT_SECRET=</code></pre>
<h3 data-ke-size="size23">마이그레이션</h3>
<p data-ke-size="size16">마이그레이션 테이블은 두 개를 만든다. 예를 들어 쇼핑몰에는 장바구니, 결제 기능이 있는데 장바구니와 결제를 위한 테이블인 <code>orders, payments</code> 테이블을 만들어보자.</p>
<h4 data-ke-size="size20">payments</h4>
<p data-ke-size="size16"><code>payments</code> 테이블에는 결제정보가 들어가게 되며 주문가격, 결제상태 등의 포함된다.</p>
<pre id="code_1648885839156" data-ke-language="bash" data-ke-type="codeblock"><code>php artisan make:migration create_payments_table --create=payments</code></pre>
<pre id="code_1648885872082" data-ke-language="php" data-ke-type="codeblock"><code>use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class CreatePaymentsTable extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('payments', function (Blueprint $table) {
            $table-&gt;uuid('merchant_uid')-&gt;primary();
            $table-&gt;string('imp_uid')-&gt;unique();
            $table-&gt;unsignedBigInteger('amount');
            $table-&gt;string('pay_method');
            $table-&gt;string('status');
            $table-&gt;timestamps();
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::dropIfExists('payments');
    }
}</code></pre>
<p data-ke-size="size16"><code>merchant_uid</code> 는 앱 내부에서 관리되는 고유의 값이므로 기본키로 설정한다. 값은 <code>auto_increment</code> 보다는 UUID 로 지정되도록 하자. <code>imp_uid</code> 는 결제가 완료되면 아임포트에서 날려주는 결제고유번호이다. 그 외에 <code>amount, pay_method, status</code> 는 각 주문가격, 결제방법, 결제상태를 의미한다. 이 또한 정해져있는 스키마는 아니기 때문에 다른 컬럼을 추가해도 되고 필요하지 않다면 빼도된다.</p>
<h4 data-ke-size="size20">orders</h4>
<p data-ke-size="size16">주문은 장바구니와 같은 기능을 하게 될 것이며 해당 테이블에 담긴 데이터는 사용자가 구입을 위해 장바구니에 담아놓은 상태를 말한다. 아직 주문이 되지 않은 상품이 있을 수 있으므로 주문에 대한 정보는 비워둘 수 있도록 한다.</p>
<pre id="code_1648797509341" data-ke-language="bash" data-ke-type="codeblock"><code>php artisan make:migration create_orders_table --create=orders</code></pre>
<pre id="code_1648798891625" data-ke-language="php" data-ke-type="codeblock"><code>use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class CreateOrdersTable extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('orders', function (Blueprint $table) {
            $table-&gt;increments('id');
            $table-&gt;unsignedBigInteger('amount');
            $table-&gt;foreignUuid('merchant_uid')
                -&gt;nullable()
                -&gt;constrained('payments', 'merchant_uid');
            $table-&gt;timestamps();
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::dropIfExists('orders');
    }
}</code></pre>
<h3 data-ke-size="size23">모델</h3>
<p data-ke-size="size16">모델 또한 장바구니를 위한 <code>Order</code>, 결제를 위한 <code>Payment</code>, 이렇게 두 개가 존재할 수 있다.</p>
<h4 data-ke-size="size20">Payment</h4>
<p data-ke-size="size16">결제를 위한 모델인 <code>Payment</code> 를 만들어보자.</p>
<pre id="code_1648886041694" data-ke-language="php" data-ke-type="codeblock"><code>php artisan make:model Payment</code></pre>
<pre id="code_1648886070263" data-ke-language="php" data-ke-type="codeblock"><code>namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;

class Payment extends Model
{
    use HasFactory;

    /**
     * The primary key for the model.
     *
     * @var string
     */
    protected $primaryKey = 'merchant_uid';

    /**
     * The attributes that are mass assignable.
     *
     * @var string[]
     */
    protected $fillable = [
        'merchant_uid',
        'imp_uid',
        'amount',
        'pay_method',
        'status'
    ];

    /**
     * Indicates if the IDs are auto-incrementing.
     *
     * @var bool
     */
    public $incrementing = false;

    /**
     * @return \Illuminate\Database\Eloquent\Relations\HasMany
     */
    public function orders()
    {
        return $this-&gt;hasMany(Order::class, 'merchant_uid');
    }
}</code></pre>
<p data-ke-size="size16">기본키를 <code>merchant_uid</code> 로 설정한 것과, 자동으로 증가하지 않도록 지정한 것에 주목하자. 또한 결제는 해당 결제에 해당하는 주문이 여러개 소속된다는 의미로 관계를 설정해주자.</p>
<h4 data-ke-size="size20">Order</h4>
<p data-ke-size="size16">장바구니를 위한 모델인 <code>Order</code> 를 하나 만들자.</p>
<pre id="code_1648799817712" data-ke-language="bash" data-ke-type="codeblock"><code>php artisan make:model Order</code></pre>
<pre id="code_1648801202366" data-ke-language="php" data-ke-type="codeblock"><code>namespace App\Models;

use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;

class Order extends Model
{
    use HasFactory;

    /**
     * The attributes that are mass assignable.
     *
     * @var string[]
     */
    protected $fillable = [
        'amount'
    ];

    /**
     * @return \Illuminate\Database\Eloquent\Relations\BelongsTo
     */
    public function payment()
    {
        return $this-&gt;belongsTo(Payment::class, 'merchant_uid');
    }

    /**
     * Not paid
     *
     * @param Builder $query
     *
     * @return Builder
     */
    public function scopeNotPaid(Builder $query)
    {
        return $query-&gt;whereNull('merchant_uid');
    }
}</code></pre>
<p data-ke-size="size16">하나의 주문은 하나의 결제에 소속될 수 있다. 또한 아직 주문되지 않은 결제들을 얻어내기 위해 <code>notPaid</code> 스코프를 지정해주는 것도 생각해볼 수 있다.</p>
<h3 data-ke-size="size23">라우팅과 컨트롤러</h3>
<p data-ke-size="size16">컨트롤러 또한 두 개를 만들어야한다. <code>Payment, Order</code> 를 위한 각 컨트롤러를 만들어주자. 리소스 컨트롤러로 지정하자.</p>
<h4 data-ke-size="size20">PaymentController</h4>
<pre id="code_1648886495559" data-ke-language="bash" data-ke-type="codeblock"><code>php artisan make:controller PaymentController --resource</code></pre>
<pre id="code_1648886584166" data-ke-language="php" data-ke-type="codeblock"><code>namespace App\Http\Controllers;

use Illuminate\Http\Request;

class PaymentController extends Controller
{
    /**
     * Store a newly created resource in storage.
     *
     * @param  \Illuminate\Http\Request  $request
     * @return \Illuminate\Http\Response
     */
    public function store(Request $request)
    {
        //
    }
}</code></pre>
<p data-ke-size="size16"><code>Payment</code> 는 리소스를 생성하는 행위만 있으면 된다. 왜냐하면 환불요청과 같은 기능은 구현하지 않을 것이기 때문이다.</p>
<pre id="code_1648888376329" data-ke-language="php" data-ke-type="codeblock"><code>Route::resource('payments', \App\Http\Controllers\PaymentController::class)
    -&gt;only(['store']);</code></pre>
<h4 data-ke-size="size20">OrderController</h4>
<pre id="code_1648886699957" data-ke-language="bash" data-ke-type="codeblock"><code>php artisan make:controller OrderController --resource</code></pre>
<pre id="code_1648886736919" data-ke-language="php" data-ke-type="codeblock"><code>namespace App\Http\Controllers;

use Illuminate\Http\Request;

class OrderController extends Controller
{
    /**
     * Display a listing of the resource.
     *
     * @return \Illuminate\Http\Response
     */
    public function index()
    {
        //
    }

    /**
     * Show the form for creating a new resource.
     *
     * @return \Illuminate\Http\Response
     */
    public function create()
    {
        //
    }

    /**
     * Store a newly created resource in storage.
     *
     * @param  \Illuminate\Http\Request  $request
     * @return \Illuminate\Http\Response
     */
    public function store(Request $request)
    {
        //
    }
}</code></pre>
<p data-ke-size="size16"><code>Order</code> 의 경우 사용자가 장바구니에 담은 목록을 표시하기 위한 <code>index</code>, 상품을 장바구니에 담기위한 <code>create, store</code> 가 있다. 일반적인 쇼핑몰에서는 <code>create</code> 는 필요하지 않고 상품 상세페이지가 대체하게 될 것이다.</p>
<pre id="code_1648888381444" data-ke-language="php" data-ke-type="codeblock"><code>Route::resource('orders', \App\Http\Controllers\OrderController::class)
    -&gt;only(['index', 'create', 'store']);</code></pre></div></div>

hELLO.

이번에 국내 서비스용 결제와 관련된 기능을 구현해보면서 사용해본 것이 아임포트(I'mport)다. 라라벨에는 물론 결제를 위한 Laravel Cashier 라는 패키지가 존재하고, Stripe, Paddle 과 연동할 수 있으나 국내 서비스에는 그다지 친화적이지 않은 측면이 있다. 따라서 구축하기도 쉽고 국내 서비스에 친화적인 아임포트를 사용해보기로 했다. 또 다른 국내 친화적인 서비스로는 Payple 이 있는데, 나중에 기회가 되면 써보기로 하자.
 
아임포트는 개발자 친화적으로 문서화가 되어있어서 개발자의 입장에서 볼 때 결제를 구현하기 상당히 수월하게 되어있다. 대표적으로 일반결제, 정기결제, 결제환불 이렇게 세가지로 되어있다. 자세한 내용을 확인하려면 아래의 문서를 참고하자. 우리가 구현할 것은 일반결제 하나 뿐이다.
 
https://docs.iamport.kr/
아임포트
아임포트와 같은 중개자를끼면 PG사의 모듈을 직접 연계했을 때와는 결제과정이 다소 바뀌게 되는데, 그림으로 한 눈에 알 수 있다.
중개자가 있기때문에 과정이 조금은 더 복잡해질 수 있지만, 사실 아임포트를 인터페이스(Interface)의 관점으로 접근해본다면, 다양한 PG사에 연동하고 싶은 경우에 각각이 다른 구현방식을 취할 필요가 없고 개발자의 입장에서는 단순 파라매터만 바꾸는 것으로 사용할 수 있는 것이다.
이미테이션
아임포트 내부에서 하는 일을 코드로 느낌만 간략하게 살펴보면 아래와 같다. 실제로 이렇지는 않을 것이다. 그저 아임포트가 각 PG사와 중개자 역할을 한다는점에 초점을 맞춘다.
 
먼저, 각 KGInicis, KakaoPay 등의 PG사를 각각 만들어주자. 여기서 Context 클래스에 들어갈만한 것들은 카드, 가상계좌 등의 결제방법, 주문가격 등이 프로퍼티로 존재할 수 있다.
class Context 
{
    // 결제방법, 주문가격 등...
}
abstract class Pg {
    /**
     * Request Payment
     * 
     * @param Context $context
     * @return bool
     */
    public abstract function requestPay(Context $context): bool;
}
/**
 * KG이니시스
 */
class KGInicis extends Pg
{
    public function requestPay(Context $context): bool
    {
        //
    }
}
/**
 * 카카오페이
 */
class KakaoPay extends Pg
{
    public function requestPay(Context $context): bool
    {
        //
    }
}
그 다음 Iamport 클래스를 하나 만들고 생성자에 사용하고자하는 PG사에 해당하는 클래스를 주입, PG사에서 구현 중인 Pg::requestPay() 를 호출, 고유주문번호를 생성해서 반환한다. 여기까지가 대략적으로 아임포트 내부에서 발생할 수 있는 일이다.
class Iamport 
{
    /**
     * 고유주문번호
     * 
     * @var string $impUid
     */
    private $impUid;
    /**
     * PG
     * 
     * @var Pg $pg
     */
    private $pg;
    /**
     * Create Iamport Instance
     * 
     * @param Pg $pg
     */
    public function __construct(Pg $pg) 
    {
        $this->pg = $pg;
    }
    /**
     * Request Payment
     * 
     * @param Context $context
     * @return string
     */
    public function requestPay(Context $context): string
    {
        if (! $this->pg->requestPay($context)) {
            return '';
        }
        // 아임포트 고유 주문번호 생성 및 저장...
        return $this->impUid;
    }
}
이렇게 작성된 모듈을 클라이언트에선 어떻게 해야할까? 그저 아임포트에서 어떤 PG사와 연동할지만 넘겨주고 요청만 보내면 그만이다. 실제로 이러한 사용법은 우리가 아임포트를 클라이언트의 입장에서 사용하는 방법과 아주 유사하다고 볼 수 있다.
$iamport = new Iamport(new KGInicis());
$context = new Context();
if ($impUid = $iamport->requestPay($context)) {
    //
}
라라벨에서 아임포트 연동준비하기
라라벨 8.x 에서 실제 아임포트 모듈을 사용하여 실제를 만들어보자. 라라벨 프로젝트를 만드는 것부터 시작이다.
laravel new iamport-payments
설정
아임포트에 대한 설정을 추가해주자. 아임포트 관리자 콘솔 - 내정보에서 클라이언트 키(Key)와 시크릿 키를 확인할 수 있는데, .env, app/services.php 에 값을 설정해주자.
config/services.php
아래의 설정은 정해진 설정이 아니라 임의로 추가한 것이기 때문에 필요하다면 수정할 수 있다. 이 경우 merchant_id 는 가맹점 식별코드를 말하는데 아임포트 관리자 콘솔에서 볼 수 있다. 마찬가지로 client_id, client_secret 도 확인할 수 있다. pg 의 경우 사용할 PG사의 식별 이름을 적으면 되는데, Javascript SDK 에서 IMP.requestPay() 의 명세에서 pg 항목을 보면 된다.
'iamport' => [
    'merchant_id' => env('IAMPORT_MERCHANT_ID'),
    'pg' => env('IAMPORT_PG'),
    'client_id' => env('IAMPORT_CLIENT_ID'),
    'client_secret' => env('IAMPORT_CLIENT_SECRET')
],
.env
다음과 같이 지정하고, 빈칸에는 관리자 콘솔에서 값을 보고 넣어주자. IAMPORT_PG 에 설정된 html5_inicis 는 KG이니시스를 의미한다.
IAMPORT_MERCHANT_ID=
IAMPORT_PG=html5_inicis
IAMPORT_CLIENT_ID=
IAMPORT_CLIENT_SECRET=
마이그레이션
마이그레이션 테이블은 두 개를 만든다. 예를 들어 쇼핑몰에는 장바구니, 결제 기능이 있는데 장바구니와 결제를 위한 테이블인 orders, payments 테이블을 만들어보자.
payments
payments 테이블에는 결제정보가 들어가게 되며 주문가격, 결제상태 등의 포함된다.
php artisan make:migration create_payments_table --create=payments
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
class CreatePaymentsTable extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('payments', function (Blueprint $table) {
            $table->uuid('merchant_uid')->primary();
            $table->string('imp_uid')->unique();
            $table->unsignedBigInteger('amount');
            $table->string('pay_method');
            $table->string('status');
            $table->timestamps();
        });
    }
    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::dropIfExists('payments');
    }
}
merchant_uid 는 앱 내부에서 관리되는 고유의 값이므로 기본키로 설정한다. 값은 auto_increment 보다는 UUID 로 지정되도록 하자. imp_uid 는 결제가 완료되면 아임포트에서 날려주는 결제고유번호이다. 그 외에 amount, pay_method, status 는 각 주문가격, 결제방법, 결제상태를 의미한다. 이 또한 정해져있는 스키마는 아니기 때문에 다른 컬럼을 추가해도 되고 필요하지 않다면 빼도된다.
orders
주문은 장바구니와 같은 기능을 하게 될 것이며 해당 테이블에 담긴 데이터는 사용자가 구입을 위해 장바구니에 담아놓은 상태를 말한다. 아직 주문이 되지 않은 상품이 있을 수 있으므로 주문에 대한 정보는 비워둘 수 있도록 한다.
php artisan make:migration create_orders_table --create=orders
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
class CreateOrdersTable extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('orders', function (Blueprint $table) {
            $table->increments('id');
            $table->unsignedBigInteger('amount');
            $table->foreignUuid('merchant_uid')
                ->nullable()
                ->constrained('payments', 'merchant_uid');
            $table->timestamps();
        });
    }
    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::dropIfExists('orders');
    }
}
모델
모델 또한 장바구니를 위한 Order, 결제를 위한 Payment, 이렇게 두 개가 존재할 수 있다.
Payment
결제를 위한 모델인 Payment 를 만들어보자.
php artisan make:model Payment
namespace App\Models;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
class Payment extends Model
{
    use HasFactory;
    /**
     * The primary key for the model.
     *
     * @var string
     */
    protected $primaryKey = 'merchant_uid';
    /**
     * The attributes that are mass assignable.
     *
     * @var string[]
     */
    protected $fillable = [
        'merchant_uid',
        'imp_uid',
        'amount',
        'pay_method',
        'status'
    ];
    /**
     * Indicates if the IDs are auto-incrementing.
     *
     * @var bool
     */
    public $incrementing = false;
    /**
     * @return \Illuminate\Database\Eloquent\Relations\HasMany
     */
    public function orders()
    {
        return $this->hasMany(Order::class, 'merchant_uid');
    }
}
기본키를 merchant_uid 로 설정한 것과, 자동으로 증가하지 않도록 지정한 것에 주목하자. 또한 결제는 해당 결제에 해당하는 주문이 여러개 소속된다는 의미로 관계를 설정해주자.
Order
장바구니를 위한 모델인 Order 를 하나 만들자.
php artisan make:model Order
namespace App\Models;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
class Order extends Model
{
    use HasFactory;
    /**
     * The attributes that are mass assignable.
     *
     * @var string[]
     */
    protected $fillable = [
        'amount'
    ];
    /**
     * @return \Illuminate\Database\Eloquent\Relations\BelongsTo
     */
    public function payment()
    {
        return $this->belongsTo(Payment::class, 'merchant_uid');
    }
    /**
     * Not paid
     *
     * @param Builder $query
     *
     * @return Builder
     */
    public function scopeNotPaid(Builder $query)
    {
        return $query->whereNull('merchant_uid');
    }
}
하나의 주문은 하나의 결제에 소속될 수 있다. 또한 아직 주문되지 않은 결제들을 얻어내기 위해 notPaid 스코프를 지정해주는 것도 생각해볼 수 있다.
라우팅과 컨트롤러
컨트롤러 또한 두 개를 만들어야한다. Payment, Order 를 위한 각 컨트롤러를 만들어주자. 리소스 컨트롤러로 지정하자.
PaymentController
php artisan make:controller PaymentController --resource
namespace App\Http\Controllers;
use Illuminate\Http\Request;
class PaymentController extends Controller
{
    /**
     * Store a newly created resource in storage.
     *
     * @param  \Illuminate\Http\Request  $request
     * @return \Illuminate\Http\Response
     */
    public function store(Request $request)
    {
        //
    }
}
Payment 는 리소스를 생성하는 행위만 있으면 된다. 왜냐하면 환불요청과 같은 기능은 구현하지 않을 것이기 때문이다.
Route::resource('payments', \App\Http\Controllers\PaymentController::class)
    ->only(['store']);
OrderController
php artisan make:controller OrderController --resource
namespace App\Http\Controllers;
use Illuminate\Http\Request;
class OrderController extends Controller
{
    /**
     * Display a listing of the resource.
     *
     * @return \Illuminate\Http\Response
     */
    public function index()
    {
        //
    }
    /**
     * Show the form for creating a new resource.
     *
     * @return \Illuminate\Http\Response
     */
    public function create()
    {
        //
    }
    /**
     * Store a newly created resource in storage.
     *
     * @param  \Illuminate\Http\Request  $request
     * @return \Illuminate\Http\Response
     */
    public function store(Request $request)
    {
        //
    }
}
Order 의 경우 사용자가 장바구니에 담은 목록을 표시하기 위한 index, 상품을 장바구니에 담기위한 create, store 가 있다. 일반적인 쇼핑몰에서는 create 는 필요하지 않고 상품 상세페이지가 대체하게 될 것이다.
Route::resource('orders', \App\Http\Controllers\OrderController::class)
    ->only(['index', 'create', 'store']);

[Laravel] 아임포트(Iamport)로 결제기능 구현하기 - 준비

댓글