Confirm a Transaction Intent

Confirm a Transaction Intent

POST https://api.pos.zmyle.de/service/v1.1/transaction_intents/:intentId/confirm

You can confirm a transaction intent as long as it has the status "NEEDS_CONFIRMATION". This will transfer the transaction intent into a transaction on the gift card. The funds will not be on hold anymore but get committed to the gift card balance.

Path Parameters

Name	Type	Description
intentId	string	Unique ID of the transaction intent.

200 Returns the transaction intent, confirmed and with referenced transaction.

{
    "expiresAt": "20171127T061957Z",
    "statementDescriptor": "MegaStore",
    "retailerId": "15h3k83g45anmatlbyie",
    "amount": 100,
    "giftcardTransactionId": "18k7e49n4n25e25wt5z9",
    "giftcardId": "18jja4mf08fn08f7gp9l",
    "id": "18k7e43ib6fnfnnfc48d34spk5nl",
    "status": "SUCCEEDED",
    "createdAt": "20171127T054957Z",
    "currency": "EUR",
    "metadata": {
        "store": "megastore-filiale-holzweg",
        "receiptNumber": "Bon 2017-79730"
    }
}

Example Request

cURL

curl -X POST https://api.pos.zmyle.de/service/v1.1/transaction_intents/18k78hj3e2j65686vhipw560u6sm/confirm \
  -u {api_key}:{api_secret}

Response Error Codes

error code	reason
api:io:malformedId	The transaction intent ID is not right.
api:biz:noSuchTransactionIntent	The API could not find the transaction intent.
api:biz:transactionIntentStatus	This transaction intent cannot be confirmed b/c its status does not allow confirmation.