Use payment captures to reconcile payments processed by PSPs
Payment captures are card or alternative payment method charges, refunds, or chargebacks processed by PSPs. While card payments cannot be initiated through Mambu Payments (formerly Numeral), they can be recorded as payment_capture
objects and reconciled with the corresponding bank transactions.
Attribute | Description |
---|---|
| The payment capture ID. |
| An idempotency key is a unique value sent by the client, which the server uses to recognize subsequent retries of the same request. See Idempotency. |
| Always |
| The ID of the connected account used for the payment capture. |
| The payment capture transaction reference, based on the bank settlement reporting file. |
| The payment capture type. Either |
| The payment capture amount, in the currency's smallest unit. For instance, euro smallest unit is cents and €20 is thus represented as |
| For chargeback and return payment captures, the original payment amount. |
| The payment capture currency. All ISO-4217 currency codes are supported. |
| The payment capture date. |
| The payment capture authorization ID. |
| The payment capture payment reference, usually a technical ID persisted throughout the processing of the payment, from its initiation to its settlement (e.g. |
| The payment capture value date. |
| The payment capture scheme or network (e.g. |
| The payment capture remittance date. |
| The payment capture remittance reference. |
| The payment capture fee amount. |
| The payment capture fee amount currency. |
| The payment capture net amount. |
| The payment capture net amount currency. |
| The payment capture source, either |
| The payment capture merchant ID. |
| The payment capture reconciliation status, either |
| The amount reconciled, calculated as the sum of the reconciliations created for the payment capture. |
| Additional data in JSON |
| The payment capture cancelation UTC timestamp. |
| The payment capture update UTC timestamp. |
| The payment capture creation UTC timestamp. |
Below is an example of a payment capture:
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"idempotency_key": "4e19a57a-0e8e-401f-b2d7-453ad41b826e",
"object": "payment_capture",
"connected_account_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"transaction_reference": "GT67178B",
"amount": 500,
"original_payment_amount": null,
"currency": "EUR",
"type": "charge",
"authorization_id": "45635726367276367213",
"payment_reference": "3FG2V3F21G3KP",
"date": "2022-01-03",
"value_date": "2022-01-03",
"network": "visa",
"remittance_reference": "string",
"remittance_date": "2022-01-03",
"fee_amount": 0,
"fee_currency": "EUR",
"net_amount": 500,
"net_currency": "EUR",
"reconciled_amount": 500,
"reconciliation_status": "unreconciled",
"source": "api",
"merchant_id": "3256136726",
"metadata": "",
"canceled_at": null,
"updated_at": null,
"created_at": "2023-09-25T08:50:07.605Z"
}