**************
Payment
**************
An object describing the payment for an order.

============================ ==================== ===================================================================================
Field name                   Type                 Description
============================ ==================== ===================================================================================
status                       String               One of ``pending``, ``completed`` or ``failed``.
reason                       String               If the status is ``failed``, this fields contains a reason for the failure, in the client's language. For all the other statuses, it is always null.
============================ ==================== ===================================================================================


.. _payment-statuses:

Payment statuses
~~~~~~~~~~~~~~~~
============ ===========================================================================================================
Status       Description
============ ===========================================================================================================
pending      We are waiting for the payment to arrive.
completed    The payment has arrived.
failed       The payment failed (see the ``reason`` field to get a clue).
============ ===========================================================================================================