Partial Payments Verifying how it works

Questions
1

Hello, just want to make sure I understand this correctly.
The situation is this, the customer creates a booking (order) and prepays 1/2 the order. The order made has all the services and a total (no tip yet). The initial payment is working per the docs https://developer.squareup.com/docs/payments-api/take-payments/card-payments/partial-payments-with-gift-cards.

But this is my first question it seems to focus on gift cards but this is not that. Then the second question is, is this payment really being paid or is it pay later when marked complete? Seems per the sandbox payload it is complete now which is great.

Lastly, and I have not tried this yet, the second payment will be for the full remaining amount plus a tip. Which I can, if needed, use the Pay for Orders endpoint. Thanks

2

:wave: That walkthrough does focus on gift card payments but with your scenario you’ll want to call CreatePayment with the order_id for the partial payment. Once the customer is ready to complete the order payment then you’ll pay for the remaining amount and tip with the same order_id. After it’s been fully paid for then you’ll call PayOrder with the payment_ids to complete the order. :slightly_smiling_face:

3

ok that sounds good. And if I get this right is the initial payment a true payment, in that it is not just Authorized but paid. From the merchants standpoint they technically have the down payment already is the goal here vs just Authorized to be made. Thanks for the quick response btw.

4

btw it is all working fine using Postman my initial go accidentally set “accept_partial_authorization” and that messed it up. My 2 payments

{
    "idempotency_key": "{{$guid}}",
    "autocomplete": false,
    "amount_money": {
        "amount": 3000,
        "currency": "USD"
    },
    "order_id": "zyu8UNRQfNreESeGQQEn2MIHT4cZY",
    "source_id": "ccof:Uuo9UHlNwOhCCmvg4GB",
    "customer_id": "QDMK3EJS9WTFZ9JPTKNMZH8DMM"
}

andPreformatted text

{
    "idempotency_key": "{{$guid}}",
    "autocomplete": false,
    "amount_money": {
        "amount": 3000,
        "currency": "USD"
    },
    "tip_money": {
        "amount": 1000,
        "currency": "USD"
    },
    "order_id": "zyu8UNRQfNreESeGQQEn2MIHT4cZY",
    "source_id": "ccof:Uuo9UHlNwOhCCmvg4GB",
    "customer_id": "QDMK3EJS9WTFZ9JPTKNMZH8DMM"
}

worked perfectly then the payOrder

{
  "idempotency_key": "{{$guid}}",
  "order_verision": 3,
  "payment_ids":[
      "X3S0ngeAIKWDgecw1oA8AYlDB8YZY",
      "dEVp49mPIAstK1hgEHl9unATtB8YY"
  	]
}

wrapped it all up. Thanks for your help

5

@Bryan-Square can you clarify if the payments are actually captured with this method or are they just authorized till the total order amount is satisfied?